/st2chatops

Packaging environment for building StackStorm chatops native packages

Primary LanguageShell

StackStorm's st2chatops

This repository delivers StackStorm Chatops in a form of packages and docker image. The package includes hubot, hubot-stackstorm and pre-installed adapters for many Chat services.

Package

Usage

For instructions to install st2chatops package from repos, please refer to StackStorm installation instruction for Deb-based or RPM-based distributions.

Make sure you've added StackStorm repos before installing the package.

Node Version

Refer to official node documentation on installing NodeJS from packages.

Building

Building of the packages is handled automatically by CircleCI. In case you'd like to run it locally, you can use our building pipeline by running docker-compose:

    docker-compose run ${DISTRO} build

Where ${DISTRO} refers to flavor name. See docker-compose.yml file for the list of supported flavors.

Docker

Usage

  • Pull the StackStorm/hubot image:

      docker pull stackstorm/hubot

  • Set a hostname or IP address that will be accessible form a docker container, as $ST2_HOSTNAME environment variable:

     export $ST2_HOSTNAME={MY_STACKSTORM_HOST_NAME}

  • Use scripts/st2chatops.env to store the settings. The example uses Slack; set appropriate environment variables for other Chat Services: Slack, HipChat, Yammer, Cisco Spark, Flowdock, IRC, XMPP.

  • Use scripts/st2chatops-docker-run.sh to start the docker container instance. The script is set for Slack; for other Chats, edit it to pass the environment variables as required for your Chat service adapter. Run the script, and ensure that hubot-stackstorm is running and there are no errors:

      ./st2chatops-docker-run.sh
  docker inspect -f {{.State.Status}} stackstorm-hubot
  docker logs stackstorm-hubot

    To automatically start stackstorm-hubot, use restart policies, or integrate with a process manager.

  • Go to your Chat room and begin Chatopsing. Learn more at docs.stackstorm.com/chatops

Node Version

Grab your favorite Node.JS version from https://hub.docker.com/_/node/, and pick your tag. Update Dockerfile as needed.

Pre-Requsites

  • Docker
  • Docker Hub Login (corporate login is in LastPass... create or attach your user to the StackStorm org)

Building

  • Step 0: Log in to docker with docker login.

    • Only have to do this the first time

  • Step 1: Build the image: docker build -t stackstorm/hubot:<VER> .

    • Replace <VER> with a version tag

  • Step 2: Push the container up: docker push stackstorm/hubot:<VER>

    • Use the same tag specified in Step 1.

  • Step 3: Update the latest tag:

    docker build -t stackstorm/hubot:latest .
docker push stackstorm/hubot:latest

  • Step 4: Profit