docs: Add on-prem Cloud claim URL guidance to claim README - #23379
Draft
nedi-app[bot] wants to merge 1 commit into
Draft
docs: Add on-prem Cloud claim URL guidance to claim README#23379nedi-app[bot] wants to merge 1 commit into
nedi-app[bot] wants to merge 1 commit into
Conversation
…odes to a self-hosted Netdata Cloud On-Prem deployment (no SaaS). In src/claim/README.md, a new 'Connecting to Netdata Cloud On-Prem (self-hosted)' section documents that claiming uses the same ACLK mechanism with only the target URL changed (claim.conf url / NETDATA_CLAIM_URL set to the on-prem Cloud base URL), and that the ACLK then connects outbound (WSS / MQTT-over-WebSocket, port 443) to the on-prem installation, not the SaaS domains. In src/aclk/README.md, a new 'Allowlisting for Netdata Cloud On-Prem' subsection clarifies that on-prem allowlisting uses the customer's own installation domains, not app.netdata.cloud/api.netdata.cloud/mqtt.netdata.cloud. The on-prem-specific Helm chart setting and infrastructure component names (Traefik/EMQX) from the plan guidance were not verifiable from this checkout (netdata-cloud-onprem repo is not present and its public docs URL returns 404), so per the docs-writing policy those are described at the behavioral level and deferred to the linked on-prem deployment docs.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Summary
Add on-prem Cloud claim URL guidance to claim README. Files changed: src/aclk/README.md, src/claim/README.md.
User Request
how does netdata parent node communicate with netdata cloud on-prem cluster? no Netdata SaaS is expected
Prompt (English)
How a Netdata Parent node communicates with a self-hosted Netdata Cloud installation in an on-prem Kubernetes cluster (no SaaS)
Reason for Change
This change applies the specific user request using repository-truth evidence from the audit execution workspace.
Summary by cubic
Add clear instructions for connecting Agents and Parent nodes to a self-hosted Netdata Cloud On-Prem by setting the claim URL to the on‑prem base URL and allowlisting only on‑prem endpoints. Clarifies that ACLK connects outbound to your on‑prem Cloud over WSS/MQTT on port 443 and never uses SaaS domains, with links to on‑prem deployment docs.
Updates:
src/claim/README.md,src/aclk/README.md.Written for commit 9666eb4. Summary will update on new commits.