[INFO] How to produce packages and debug an issue locally?

Generating packages locally

1. Spin a fresh ubuntu VM
   • git clone https://github.com/manasdk/st2-test-ground
   • HOSTNAME=PKGS_BOX vagrant up u14 --no-provision
   • vagrant ssh u14
2. Inside the VM, install the following pre-requisites
   • sudo apt-get install python-pip
   • sudo pip install --upgrade pip
   • sudo -H pip install docker-compose
   • Install docker by following instructions here: https://docs.docker.com/engine/installation/ubuntulinux/
3. Fetch the st2-packages repo and checkout the appropriate branch:
   • git clone https://github.com/StackStorm/st2-packages.git
   • git checkout ${branch}
4. Get ready to build:
   • sudo docker-compose kill
   • sudo docker-compose rm -f
5. Now build packages:
   • sudo docker-compose run --rm wheezy # You can also run packages for trusty, el6, el7 etc

Debugging

After build and test stages finished all docker containers remain active, so you are welcome to some more in-depth testing if desired. To do so simply run:

1. List containers
   • sudo docker ps

     Find the required testing container

     In our case it will be st2packages_wheezytest_1

2. Get a shell inside container
   • sudo docker exec -it st2packages_wheezytest_1 bash

Once done, you are inside the testing environment where all services are up and running. Don't forget to do (after exec):

export TERM=xterm
At this point you can do any manual testing which is required.

No target file or test is named. Start by locating the repository's existing package-build documentation and compare it with the Ubuntu, Docker Compose, package build, and container-debugging steps in the issue. Done means the local build and debugging procedure is documented accurately in the appropriate project location.