docs: add Datacenter access section (Netbird VPN + board access)#936
Conversation
New CONTRIBUTE page for board maintainers: how to reach the hardware lab. - Connect to the Datacenter over the Netbird VPN (netbird.armbian.com), authenticating via GitHub; access is gated to the board-maintainers team. - Find boards in NetBox (netbox.armbian.com) and SSH to them by IP. - A "Boards" list scaffolded with <!-- BOARDS-START -->/<!-- BOARDS-STOP --> markers, to be auto-updated via PR from NetBox (same mechanism as the wireless performance results); generator to follow. Signed-off-by: Igor Pecovnik <igor@armbian.com>
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
✅ Files skipped from review due to trivial changes (1)
WalkthroughThis pull request adds a new documentation page,
Estimated code review effort: 1 (Trivial) | ~5 minutes Related issues: None specified. Related PRs: None specified. Suggested labels: documentation Suggested reviewers: None specified. 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Embed the Armbian Datacenter rack photo (images/dc-rack.png) at the top of the Datacenter access page. Signed-off-by: Igor Pecovnik <igor@armbian.com>
The board-maintainers team is 'closed' (visible to org members), so an existing Armbian org member can self-serve "Request to join" from the team page; non-members need to join the org first. Add both paths. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Boards install each maintainer's GitHub SSH public keys into root's authorized_keys, so access is `ssh root@<ip>` with no password (your matching private key). Make the instructions specific. Signed-off-by: Igor Pecovnik <igor@armbian.com>
NetBox isn't accessible to board maintainers, so point board lookup at the auto-generated Boards list on this page instead. That list is refreshed by the reconcile action (scans the Datacenter, opens a PR), like the wireless performance results. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Reflashing is still under testing; if a board gets bricked, report it on Discord so it can be recovered. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Populate the BOARDS-START/STOP block with an initial snapshot of the active device-under-test boards + their datacenter IPs, from the reconcile run 28750845570 (via NetBox). One board (lc-opi3) dropped: its primary IP is a docker 172.17.x address, not VPN-reachable. The reconcile action will keep this refreshed via PR from here on. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Seed the Boards table with the full column set the generator produces: Board | IP | Boot | Link | Switch | PDU | Last seen. Matches the autotests board-list.py output so the first automated refresh is a clean no-op. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/Contribute/Datacenter.md`:
- Around line 94-96: The Datacenter board description currently states that the
list is already kept up to date automatically, but this change only adds the
static snapshot/scaffold. Update the wording in the Datacenter docs to use
future/intent language such as “intended to be kept up to date automatically,”
or point to the actual refresh job if that exists, so the text matches the
current implementation.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 09084260-3266-4eb4-ab66-f730de05f663
⛔ Files ignored due to path filters (1)
docs/images/dc-rack.pngis excluded by!**/*.png
📒 Files selected for processing (2)
docs/Contribute/Datacenter.mdmkdocs.yml
…already automatic" Point at the actual refresh job (Inventory: scan & reconcile / the publish-boards step) and describe what it does — reads correctly both before and after that job is live, rather than claiming the static seed is already self-updating. Signed-off-by: Igor Pecovnik <igor@armbian.com>
|
@SuperKali Did I missed anything? |
|
I give a look in the morning later, I just woke up now |
|
@igorpecovnik Most of the information regarding Netbird is correct, but as you mentioned before, take screenshots from the forum and add them there—because users might not realize that to log in to Netbird, they need to click “Use Authentik” and then click the GitHub logo below it in Authentik. I’d also add that the board has its own FQDN: slug.test(1,2).armbian.lan, in case that’s of interest. |
Signed-off-by: Igor Pecovnik <igor@armbian.com>
8a9aa5d to
835168c
Compare
Add the two Netbird/Authentik auth screenshots and walk the browser step: 1) choose "Continue with Authentik", 2) click the GitHub icon on the Armbian Auth page. Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Signed-off-by: Igor Pecovnik <igor@armbian.com>
Adds a Datacenter access page under CONTRIBUTE for board maintainers who need to reach the hardware lab.
What's covered
netbird up --management-url https://netbird.armbian.com; authentication is via GitHub, gated to the board-maintainers team.<!-- BOARDS-START -->/<!-- BOARDS-STOP -->markers and a placeholder, to be auto-updated via PR from NetBox (same mechanism as the wireless-performance table). The CI generator is a follow-up.Please sanity-check the specifics
I wrote the Netbird steps from the standard self-hosted GitHub-SSO flow; confirm these match the real setup:
https://netbird.armbian.com(no custom port)?pkgs.netbird.io/install.sh) is the method you want to recommend?ssh <user>@<board-ip>, e.g.root@10.0.50.42) since I didn't want to invent credentials/key handling — tell me the actual login (root? per-maintainer key?) and I'll make it exact.Follow-up
Want me to build the NetBox→PR generator (in
autotests) that fills the Boards table between the markers, like the iperf/wireless doc PR? I can wire it up next.Documentation website preview will be available shortly:
Open WWW preview