Permit use of service role with change set workflow

CHANGES.md

@@ -1,5 +1,9 @@
 # CHANGES
 
+## 1.6.0 (2020-11-19)
+
+* Feature: Support --service-role-arn on "change-set create"
+
 ## 1.5.1 (2020-11-16)
 
 * Fix: Recognise that template is in S3 when URL is formatted like `s3.REGION.amazonaws.com`

README.md

@@ -216,6 +216,8 @@ You can also create, list, inspect, apply and delete [change sets](http://docs.a
 
 The change-set name defaults to "pending", but can be overridden using `--name`.
 
+The `change-set create` subcommand, like the `up` command, supports `--service-role-arn` to specify a service role.
+
 ## Programmatic usage
 
 Get a handle to a `Stack` object as follows:
@@ -300,13 +302,19 @@ This policy grants the principal all actions required by `stackup up` for any cl
 }
 ```
 
-## Releasing
+## Development
+
+### Running tests
+
+`auto/test` will run the tests in a Docker container.
+
+### Releasing
 
-The release process will push tags to GitHub, push the gem to rubygems and push the docker image to DockerHub.
+Releasing is done manually, not by CI. The release process will push tags to GitHub, push the gem to rubygems and push the docker image to DockerHub.
 
 Prerequisites:
 
-* logged into dockerhub via `docker login`. Your user must have permission to push to `realestate/stackup`
+* You must be logged into docker hub via `docker login`. Your user must have permission to push to `realestate/stackup`
 * You must have a rubygems account with permission to push to the `stackup` gem. (`auto/release` will ask for your username and password)
 * You must have cloned this repo via HTTPS and have a github account with permission to push. (`auto/release` will ask for your username and a GitHub personal access token)
 

auto/dev-environment

@@ -0,0 +1,11 @@
+#! /bin/bash -e
+#
+# Run rake
+
+cd $(dirname $0)/..
+
+trap "docker-compose down --volumes" 0
+
+docker volume create --name ruby2.6-bundle-cache > /dev/null
+docker-compose run --rm dev sh -c 'bundle check > /dev/null || bundle install'
+docker-compose run --rm dev bundle exec "${@-bash}"

auto/test

@@ -0,0 +1,8 @@
+#! /bin/bash -eu
+#
+# Run tests
+
+cd $(dirname $0)/..
+
+echo "--- Running specs"
+./auto/dev-environment rake spec