#1225 Update ServiceDiscovery documentation and samples to include Custom Providers

[leonluc-dev]

Closes #1225

• Is Custom Service Discovery or Dynamic Route Registration Supported? #1225

The new section in service discovery documentation on how to implement a custom service provider.

Proposed Changes

• Add "Custom Providers" section to Service Discovery documentation
• Add new OcelotServiceDiscovery sample with initial solution of custom service discovery provider

[raman-m]

Hi @leonluc-dev ! Leon or Leonluc?
So great to see that people working on writing docs! 🤣
I will check tomorrow...

[raman-m]

Hey @leonluc-dev !
Did you check current open issues and maybe there is some issue which is related to custom ServiceDiscovery providers?
It would be highly welcomed to attach an issue to this PR.

[raman-m]

@leonluc-dev
I expect that you have some real working solution.
Did you write some unit tests and/or acceptance tests for this "Custom service discovery providers" feature?

[leonluc-dev]

@raman-m Thank you for the response.

I made no modifications to the Ocelot code itself. What I've documented was an already present and tested Ocelot interface (IServiceDiscoveryProvider) I've been using in my own code for a while now using the public Ocelot NuGet packages.

Most if not all of the Ocelot code this documentation example utilizes is already unit tested through the ServiceDiscoveryProviderFactory and related tests: ServiceDiscoveryProviderFactoryTests

While there have been no Github issues directly related to this particular interface, there have been questions about custom service discovery in the past (example: #1225)

If this interface/code was not meant to be used in that sense then this PR can be closed without merge.

Otherwise I do have a working project where I utilize a custom service discovery provider. I could turn that into a proper sample and add it to samples if necessary? (I should have a bit of time for that later this or next week)

[raman-m]

@leonluc-dev
Thanks for the reply!

Otherwise I do have a working project where I utilize a custom service discovery provider. I could turn that into a proper sample and add it to samples if necessary? (I should have a bit of time for that later this or next week)

It is not required, but it will be highly welcomed to add.

Regarding tests. Yes, current tests should cover custom provider.
I am not sure the example in docs is canonic. But, real working solution in samples will be very useful.
In the future we can link a Sample app from this doc to show how to build custom providers.

Once again,
Thanks for sharing of your practical case!
That's how to make Ocelot customizable, even in such kind of critical features of Ocelot core.

[leonluc-dev]

@ramam-m I have added the sample for custom service discovery providers to the PR.

[raman-m]

It was bad idea to include the new sample project right to this PR which was about docs updating.
Now we have broken pipelines and I need to review once again.
It was better to create separate PR. Well... Now it is too late. I forgot about asking you to prepare second PR...

Leon, you should expect that this PR will have long story...

[leonluc-dev]

@raman-m Apologies for the misunderstanding.

If it makes it easier, I can rebase the branch and remove the commit involving the sample from this PR. Afterwards I can add the sample to a new seperate PR.

[raman-m]

Leon,
Do nothing with this PR. I've started code review...

And just FYI, your develop branch is not canonic now. And your source repo develop branch should have the same top commits in target/base branch. You will be blocked in creation of new feature branches, because both develop branches must be synchronized always.
Hope you see...

[raman-m]

You've saved all code in the samples/OcelotCustom/ folder.
But what is custom?
The current folder structure use exact marker of an environment.

Please move all code to folder samples/OcelotServiceDiscovery/!

Second,
I don't see your sample solution in VS solution folders!

You need to add your sample to samples solution folder as service-discovery solution folder. Use eureka folder as an example.

So, your projects should be added to Ocelot.sln file!
That's how your projects will be compiled and checked by CI-CD pipelines.

[leonluc-dev]

@raman-m The requested changes should be addressed now.

[raman-m]

@leonluc-dev
The feature branch has been rebased onto ThreeMammals:develop!
Welcome to code review!

[raman-m]

@schwede Hi Swede!
Could you look at this PR and review the sample please?
Do you like it?
Did you get answers on your questions from original your issue?

[raman-m]

@leonluc-dev Congrats! 🎉