An AWS Rack runs apps in the cloud. This makes it easy to build and run apps for staging and production.
You need a Convox account to set up an AWS integration and install a Rack. Check out the organizations guide for instructions.
You will also need the
cx tool on your computer to deploy apps to the Rack. Check out the CLI guide for more details.
Finally, you will need an AWS account. A new account qualifies for the AWS free tier, which offers a great way to try Convox with little to no cost. Check out the AWS Free Tier for more details.
Visit the integrations page. This is the hub that connects your organization to other service providers like AWS for infrastructure and GitHub for source control.
Click the Enable AWS button.
We’ll name the AWS integration “production” because it will connect to our primary AWS account and eventualy host our production Rack and apps.
Next, supply administrator access keys. Convox will use these keys once to set up the integration, then discard them.
Create a new “IAM user with programmatic access” to generate new keys. Follow the Creating an IAM Users guide to generate these.
Now you can drag the “credentials.csv” file onto the New AWS Integration form.
Then click “Enable”. You’ll see a confirmation message like “AWS integration enabled for account 922560784203”. Convox is now integrated with your AWS account and can set up Racks.
Finally you can delete the “convox-temp” IAM user.
Next visit the new Rack page. Here you can install Rack in your AWS account.
Name the Rack after what types of apps it will run. Common names are “dev”, “staging” or “production”.
Click “Install”. You’ll see a confirmation message the the “Rack is installing”. In a few minutes you will see a status of “installed”, and your Rack will be up and running.
First connect the
cx command to your Convox account.
$ cx login Email: firstname.lastname@example.org Password: ***** Authenticating with ui.convox.com: OK
Then you can list your Racks and switch to your production Rack:
$ cx racks RACKS myorg/production myorg/staging local $ cx switch myorg/staging OK