docs: unmanaged gateway development guide #925
Closed
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.
What type of PR is this?
/kind documentation
What this PR does / why we need it:
In a previous discussion as well as a document shared with contributors we pondered and talked about how we might handle "unmanaged gateways", which are
Gateway
resources that would reference an existing server that would otherwise not be provisioned by or have its lifecycle managed by theGateway
controller implementation itself. Several implementors noted that supporting an unmanaged gateway option was something they wouldneed ultimately, but we decided it wasn't something that would be easy (or even ultimately correct) to express via the
Gateway
specification. Given that context and during a community sync it was suggested to start a guide which would provide high level, and example style ideas about how to implement this, if nothing else just so we had some guidance for future implementors, this patch adds such a guide.Which issue(s) this PR fixes:
Fixes #892
Does this PR introduce a user-facing change?:
Additional Notes:
I only ended up covering the topics of:
Services
I know this is very limited at this point, but I wanted to start small to see how this was received. I would invite others who've solved similar problems to continue growing the guide according to their experience.