HP4T

Usage

Usage:

hp4t <command> [options]

Commands:

• help - display help
• init <language> - initialize project
• export <application> - Export Heroku application configuration
• export-pipeline <pipeline> - Export Heroku pipeline configuration
• provision-pipeline - Configure Heroku pipelines
• provision <environment> - Configure Heroku application
• deploy <environment> - Deploy application
• promote <environment> - Promote application to next environment
• run-remote <environment> <command> - Run command on Heroku
• run-local <environment> <command> - Run command locally
• notify-rollbar - Notify Rollbar about deployment

Options:

• --branch <branch_name> - deploy only from a specific branch
• --tags - deploy only from tags
• --slug <slug_name> - deploy only from specific repository slug

Example .travis.yml flow

Trunk base development:

language: node_js
node_js: 6
env:
  global:
  # ROLLBAR_DEPLOY_KEY
  - secure: ""
  # HEROKU_API_KEY
  - secure: ""
cache:
  apt: true
  directories:
  - node_modules
install:
- npm install
- alias hp4t="$(npm bin)/hp4t"
before_script:
- npm test
- hp4t provision-pipeline
- hp4t provision stage
- hp4t run stage "migrate database"
- hp4t deploy stage
- hp4t provision production
- hp4t promote stage # to production
- hp4t run production "migrate database"
script:
- /bin/true
after_success:
- hp4t notify-rollbar

With feature branch:

language: node_js
node_js:
- 6.0
env:
  global:
  # ROLLBAR_DEPLOY_KEY
  - secure: ""
  # HEROKU_API_KEY
  - secure: ""
cache:
  apt: true
  directories:
  - node_modules
install:
- npm install
- alias hp4t="$(npm bin)/hp4t"
before_script:
- npm test
- hp4t provision-pipeline
- hp4t provision stage
- hp4t run stage "migrate database"
- hp4t deploy stage
- hp4t provision production
- hp4t promote stage # to production
- hp4t run production "migrate database"
- hp4t deploy featureX --branch featureX
script:
- /bin/true
after_success:
- hp4t notify-rollbar

Continuous delivery (deploy on tag):

language: node_js
node_js:
- 6.0
env:
  global:
  # ROLLBAR_DEPLOY_KEY
  - secure: ""
  # HEROKU_API_KEY
  - secure: ""
cache:
  apt: true
  directories:
  - node_modules
install:
- npm install
- alias hp4t="$(npm bin)/hp4t"
before_script:
- npm test
- hp4t provision stage --branch develop
- hp4t run stage "migrate database" --branch develop
- hp4t deploy stage --branch develop
- hp4t provision production --tags --branch master
- hp4t deploy production --tags --branch master # to production
- hp4t run production "migrate database" --tags --branch master
- hp4t deploy featureX --branch featureX
script:
- /bin/true
after_success:
- hp4t notify-rollbar

Configuration

File: .hp4t.yaml, format YAML.

Example:

infrastructure:
- dir: infrastructure/
environments:
  default:
  - slug: wojtekk/hp4t
  - branch: master
  stage:
  - app: app_name-stage
  - branch: develop
  - tags: false
  production:
  - app: app_name
  - branch: master
  - tags: true