Skip to content

docs: add Ansible IaC guide for tenant configuration#759

Draft
SunsetDrifter wants to merge 1 commit into
mainfrom
docs/ansible-iac
Draft

docs: add Ansible IaC guide for tenant configuration#759
SunsetDrifter wants to merge 1 commit into
mainfrom
docs/ansible-iac

Conversation

@SunsetDrifter
Copy link
Copy Markdown
Contributor

Summary

  • New page Configure NetBird with Ansible at /selfhosted/iac/ansible, documenting the community.ansible_netbird collection for managing tenant resources (users, groups, setup keys, policies, networks, DNS, posture checks, IdPs) declaratively against the REST API.
  • New sidebar group Infrastructure as Code under Self-Host NetBird, sized to accept additional IaC tools later (e.g. Terraform).
  • Cross-link from selfhosted/automated-setup.mdx so operators who just minted their first PAT see the declarative next step.

Scope notes

  • Covers tenant configuration only. Fleet-installing the NetBird client on machines via Ansible is intentionally out of scope; that use case is already mentioned in manage/peers/register-machines-using-setup-keys.mdx.
  • The collection works against any NetBird tenant (cloud or self-hosted); the page calls that out explicitly so the placement under Self-Host doesn't mislead cloud operators.
  • Links out to upstream examples/ instead of mirroring playbooks that would rot.

Document the community.ansible_netbird collection for managing NetBird
resources (users, groups, setup keys, policies, networks, DNS, posture
checks) declaratively via the REST API. Adds a new Infrastructure as
Code subsection under Self-Host NetBird with room for future entries.

Cross-links from the Automated Setup PAT bootstrap page since the
collection is the natural next step after obtaining the first token.
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 18, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 14405d71-7228-4070-90fc-8fb0afe19e88

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/ansible-iac

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant