[Gap]: Document in-cluster connector discovery network prerequisites and recovery
I maintainer di solito rispondono entro 1 giorno
Valutazione
- Difficoltà
- 3/5
- Tempo stimato
- 1-2 giorni
- Idoneità per principianti
- 78/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- helm, kubernetes
- Ambito
- documentation
Direzione di ricerca
Inizia da docs/connector-gateway/connectors.mdx e dalle pagine sulla configurazione e sul deployment della piattaforma, quindi confronta la descrizione di allow_private_ips nello schema dell’API. Documenta i valori dell’allowlist di Helm, il rilevamento del Service CIDR, i controlli dello stato dei connector, il ripristino tramite nuovo salvataggio e le concessioni ai gruppi di directory. Il lavoro è completo quando il percorso dal rilevamento alla messa in servizio e la sequenza di troubleshooting sono chiari senza dipendere da un CIDR specifico di kind.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
What needs documentation?
The Manage connectors page says discovery picks up MCP servers running in the cluster and that activating a connector performs an endpoint check. It does not explain the operator-side network prerequisite that makes those discovered in-cluster endpoints pass the check.
Document the complete discovery-to-serving path:
- Discovery returns an in-cluster Service endpoint and recommends
allow_private_ips: truefor that candidate. allow_private_ipsalone does not authorize Enterprise Manager's verification dial to arbitrary private addresses.- The platform operator must configure
enterprise-manager.directory.connectorVerification.allowedPrivateRangeswith the cluster ranges that discovered endpoints may use. - For Kubernetes Service endpoints, the value must include the cluster's actual Service CIDR. Operators should derive it from the target cluster rather than copy a kind-specific default.
- Without the allowlist, connector creation can succeed while the connector is persisted in
failure; onlyavailableconnectors are served. - After fixing the allowlist, an existing failed connector must be updated/re-saved to trigger verification again. A Helm upgrade alone does not re-check persisted rows.
- A newly available connector still needs directory-group grants before non-admin users can see it.
Include a values example and a verification/troubleshooting sequence that checks connector status after admission.
Context and references
The platform's operator-allowlist design was implemented by:
https://github.com/stacklok/stacklok-enterprise-platform/issues/3644
The current public API schema documents that the discovery result's allow_private_ips value is only a recommendation, but it does not lead operators to the Helm allowlist or explain why a successful create remains unserved.
Relevant source pages:
docs/connector-gateway/connectors.mdxdocs/platform/enterprise-platform/configure-connector-gateway.mdxdocs/platform/enterprise-platform/deployment.mdxstatic/api-specs/enterprise-manager-api.json
Use case
As a platform operator importing MCP servers discovered in Kubernetes, I need to authorize the correct private cluster range and know how to recover failed verification, so that discovered connectors become available without weakening the SSRF boundary or hardcoding a distribution-specific CIDR.
- Lingua principale
- JavaScript
- Stelle
- 4
- Fork
- 4
- Merge medio
- 23h 10m
- PR unite (30g)
- 71
Preparare l'ambiente
Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di stacklok/docs-website
-
documentation enhancement needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
stacklok/docs-website#1258 ·
I maintainer di solito rispondono entro 1 giorno
-
documentation enhancement needs-triage
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
stacklok/docs-website#1241 ·
I maintainer di solito rispondono entro 1 giorno
-
bug documentation needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
stacklok/docs-website#1149 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
stacklok/docs-website#1143 ·
I maintainer di solito rispondono entro 1 giorno
-
needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
stacklok/docs-website#564 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di stacklok/docs-website
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
-
fix(套件): test_bundle 往仓库的 preset/skills 写哨兵，并发跑的 test_installer 拷贝时撞 ENOENT（CI 红）Forse già presa @Miaotofu01 l’ha presa oggi. Apertaneeds-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
Miaotofu01/Study-Mate#216 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 78/100
-
beginner-friendly category:fixtures community enhancement first-timers-only good first issue hacktoberfest help wanted low hanging fruit micro-contribution type: task up-for-grabs
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
Berserk-hub150/skillhawk#229 · 1 commento ·
I maintainer di solito rispondono entro 8 giorni