Deploying with Convox
At Convox we are obsessed with great dev tools. Like many of our users, we have been big fans of CircleCI for a long time. In fact, we use CircleCI to build and test many of the components of the Convox platform. While we have always offered the ability for Convox users to create their own integrations with CircleCI using deploy keys, today we are announcing our official CircleCI integration which makes deploying to Convox from CircleCI easier than ever.
In addition to creating a CircleCI Orb for seamless integration into CircleCI workflows, we have also officially joined the CircleCI Technology Partner Program which means you can have the confidence that our integration has been reviewed and certified by the team at CircleCI to ensure the integration is sound.
Once you have your accounts in order the first thing you will want to do is get your application deployed to Convox. You can follow our getting started guide and you should have your first app deployed in just a few minutes! Now that everything is working it’s time to start using the Convox Orb as part of your CircleCI workflow. First go to the settings section in your Convox account and generate a new deploy key for CircleCI to use and copy it to your clipboard. Next go back to CircleCI and add a new environment variable to your project named
CONVOX_DEPLOY_KEY and paste the copied deploy key as the value.
Once you have everything setup it’s easy to use the Convox Orb and add the Convox Deploy command to your CircleCI workflows. As an example if you have a Convox rack named “production” and a Convox app named “example” you can deploy with the following config.yml
version: 2.1 orbs: convox: firstname.lastname@example.org workflows: deploy: jobs: - deploy jobs: deploy: executor: convox/cli steps: - checkout - run: make test - convox/deploy: rack: production app: example
A few important notes. First you need to specify
version: 2.1 in your config.yml in order to use orbs on CircleCI. Second if you want to use the Convox Orb deploy command you need to make sure it’s preceded by a
checkout command otherwise Convox won’t have any code to deploy! Go ahead and check out the Convox Orb. We think there is no easier way to build, test, and deploy your app to AWS ECS than CircleCI + Convox.