Add Documentation for Chocolatey Proxy feeds

steviecoaster

We're currently writing documentation to guide users on how to set up a proxy repository that uses the Chocolatey Community Repository as its upstream.

You have existing documentation at https://docs.inedo.com/docs/proget/feeds/chocolatey that discusses the specific Chocolatey Feed type available within ProGet.

I'm wondering if you would be amenable to adding a section specifically about configuring a Proxied feed, with the Chocolatey community repository set as its upstream.

The important information to properly set up the feed would be that the NuGet version would need to be set to v2 on the upstream side, as that is currently what the CCR supports, and ensure that the upstream URL is https://community.chocolatey.org/api/v2. This will avoid redirects and other issues that may arise in making the connection.

I'm happy to collaborate with you folks to make this change. I think it will simply things for our users.

stevedennis

Hi @steviecoaster ,

We haven't had any users ask for help on this; it's pretty straight-forward in ProGet, as the UI guides users to do this and even pre-populates the default URLs. But if you think there's some nonobvious things or issues you've seen, then a technical note would be great (like we have on Connectors for Debian Feeds).

I should note... we did not create a dedicated HOWTO guide for this use case (unlike, for example, HOWTO: Proxy Packages from NuGet.org in Visual Studio or CLI), mostly because we don't generally recommend it. Instead, we recommend internalizing the packages.

What do you think about editing this section to clarify that?

https://docs.inedo.com/docs/proget/feeds/chocolatey#internalizing-chocolatey-packages

Thanks,
Steve

steviecoaster

We need to be careful with content about internalizing. Our commercial Package Internalizer feature handles this automatically, so our "Set up a Proxy repository" needs to point to vendor-specific content on that topic.

We definitely recommend an embedded package; however, where everything needed is included in the compiled nupkg!

For our purposes, a technical note on what to click in the ProGet UI to get a user to the place to set up the Proxy feed is good enough! We just want a specific place in the vendor documentation we can point to from our own documentation on configuring a proxy repository.

We're going through the same exercise with other repo vendors as well :D