st2docs icon indicating copy to clipboard operation
st2docs copied to clipboard

StackStorm Exchange Docs or Guide

Open mickmcgrath13 opened this issue 4 years ago • 1 comments

Problem

The docs on hosting your own exchange is more of a mention of the mechanism than it is "how to do it", and it's not clear how to generate the index.

Solution

A specific doc or guide for how to host your own exchange and how to generate the index (and where to put it) like:

  1. create an org in github (or a project in gitlab)
  2. set up auth to your private exchange (ssh, git config, etc)
  3. set up a script (in ci/cd or something) to create the index
  4. update st2 config to point to index

It would be ideal, too, if there were a separate script or something hosted somewhere to build the index that folks can include in their own ci/cd processes

mickmcgrath13 avatar Dec 01 '20 18:12 mickmcgrath13

+1 good stuff.

@mickmcgrath13 want to create a better documentation around that, maybe together with @punkrokk? Keeping in mind his past experience in building his own index fork, that might be a good tandem.

It could be a st2docs section, tutorial or maybe even a blog post? Whatever you'll find more useful.

arm4b avatar Dec 01 '20 20:12 arm4b