Home

Welcome to the exchange-incubator wiki!

Howto: Create a new StackStorm-Exchange pack

This is documentation for StackStorm-Exchange maintainers, so that future generations know how to create new Packs on the exchange from PRs on this incubator repo.

# the name of the new pack you want to create
export PACK='xxx'

#### The following are secrets that will be given to you by a Senior StackStorm Maintainer
# StackStorm Exchange machine user
export USERNAME='xxx'
# password for the user above
export PASSWORD='xxx'
# secret CircleCI token for StackStorm-Exchange organization
export CIRCLECI_TOKEN='xxx'
# URL to Slack webhook for GitHub event notifications (not sure where this one goes)
export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx
# URL to Slack webhook for GitHub event notifications going to #community
export SLACK_WEBHOOK_URL_COMMUNITY=https://hooks.slack.com/services/xxx


# clone our ci repo that contains the script to setup the pack
git clone https://github.com/StackStorm-Exchange/ci/
cd ci/utils

# <pack> is the short name of the pack, example "puppet"
./exchange-bootstrap.sh "$PACK"

# go back up a few levels
cd ../../

# clone the new repo
git clone "[email protected]:StackStorm-Exchange/stackstorm-${PACK}.git"
cd "stackstorm-${PACK}"

# clone the copy of the incubator
git clone [email protected]:<pr-submitter>/exchange-incubator.git

#####################
# NOTE: The following may differ depending on how to user submitted their PR

##########
# Scenario 1:
#   User submitted their PR by forking exchange-incubator and create a sub-directory like so:
#     exchange-incubator/stackstorm-xxx

# checkout the branch they submitted
cd exchange-incubator
git checkout <pr-branch>
cd ..

# copy the code from the forked exchange-incubator
cp -r "exchange-incubator/stackstorm-${PACK}" .

# remove the incubator fork
rm -rf exchange-incubator

# add all of the code and push it
git add .
git commit -m "Initial migration from incubator"
git push origin master