External Services
CircleCI

You can deploy to Convox as part of a CircleCI workflow using the Convox Orb

Sign Up for CircleCI

If you don’t have an account already, sign up for CircleCI.

Configure Your CircleCI Project to Build With Convox

If you don’t already have a project setup in CircleCI you will need to add one

Once you have your project added, login to the Convox console and click on the settings tab in the left side navigation bar.

From here generate a deploy key and copy it to your local clipboard.

In CircleCI, add an environment variable with the name CONVOX_DEPLOY_KEY and paste your deploy key as the value

Build a CircleCI config.yml Using the Convox Orb


Note: You must specify version: 2.1 in your config.yml in order to use Orbs


The Convox Orb contains a single deploy command and matching job for deploying your app to Convox using CircleCI.

The job is self contained. If you would prefer to use the command you must run the checkout command before using deploy.

The deploy Job/Command accepts the following parameters:

Name Description Required Default Value
rack The Rack to deploy to Yes
app The App to deploy No Project Repository Name
host Your console hostname No console.convox.com

Examples

The simplest version of a config.yml would look like:

version: 2.1
orbs:
  convox: convox/orb@1.4.1
workflows:
  deploy:
    jobs:
      - convox/deploy:
          rack: production
          app: example

This will build and deploy your app in a single step

If you would prefer to use the Convox Orb commands directly you need to run the checkout command before deploy:

version: 2.1
orbs:
  convox: convox/orb@1.4.1
workflows:
  deploy:
    jobs:
      - deploy
jobs:
  deploy:
    executor: convox/cli
    steps:
      - checkout
      - run: make test
      - convox/deploy:
          rack: production
          app: example