Can't find docs on how to create cluster internal-only Knative service

[ahmetb]

I searched for:

• internal only knative app
• knative services without external endpoint
• knative do not expose

but didn't land anywhere in the docs repo explaining how this can be done. Are we lacking docs on this topic?

/kind bug
/area serving
/area networking

[tcnghia]

We have some docs in https://github.com/knative/docs/blob/master/serving/cluster-local-route.md, but it is evident from this bug that we should make it more visible.

[ahmetb]

@tcnghia yeah the wording is not great in that doc.

The fact that "making routes local to your cluster" is means to an end. Users are interested in the "end" part of it, which is "how do I do X".

[ahmetb]

Let's try to fix this. Other people hit this just asking me where can I find docs about how to create internal/external services on Knative.

[abrennan89]

Hey folks. I went to look into this issue and maybe assign it to myself, but it looks like it could be covered now at https://knative.dev/docs/serving/cluster-local-route/ ?

[abrennan89]

Maybe there is scope here instead to have a top level section on "Configuring access for Knative Services" and then break this down into internal and external access, defaults, etc, so that it provides better context for users?

[abrennan89]

/assign abrennan89

@samodell assigning this to myself to work on if that's OK 🙂 lmk what you think / if there are any issues with this. Thanks!

[samodell]

Hey @abrennan89 , go for it! I think the main problem is discoverability; we have a lot of the info, but it's called out in a confusing way. "Cluster local route" isn't what folks think of when they're thinking about creating an internal-only or private service, but that's what the main page that talks about this is called.

[RichieEscarez]

This topic about internal k8s services also exists and is related: https://knative.dev/docs/serving/knative-kubernetes-services/

We should tie these topics together into a thorough overview and then nest the related "task" topics under that overview (how to do X (and WHY)). See Proposed navigation structure here

Thank you @ahmetb and @abrennan89 for surfacing this issue (or content gap) and taking it on!

[ahmetb]

This topic about internal k8s services also exists and is related: knative.dev/docs/serving/knative-kubernetes-services

this seems to be a misunderstanding. we're not talking about Kubernetes Services that are created as part of Knative installation; we're talking about Knative Services created by users (which aren't explained in this linked doc, or anywhere else).