Pegasus provides native support for Digital Ocean App Platform. To build for Digital Ocean, choose the “digital_ocean_app_platform” option when installing Pegasus. Then follow the steps below to deploy your app.
If you haven’t already, create your Digital Ocean account. You can sign up with this link to get $100 credit and help support Pegasus.
Next, install and configure the
doctl command line tool by following these instructions.
Additionally, you must connect Digital Ocean to your project’s Github repository. This can be done from inside App Platform, or by following this link.
Once you’ve configured the prerequisites, deploying is just a few steps.
First create your database clusters. Postgres is required and Redis is necessary to use Celery.
In the commands below you’ll need to replace
<your-project> with the values from
doctl databases create <your-project>-db --engine pg --num-nodes 1 --version 12 doctl databases create <your-project>-redis --engine redis --num-nodes 1 --version 7
Next edit the
/deploy/app-spec.yaml file. In particular, make sure to set your Github repository and branch.
If you aren’t using Celery, you can remove the sections related to redis, and the celery-worker.
doctl apps create --spec deploy/app-spec.yaml
That’s it! In a few minutes your app should be online. You can find and view it here.
After deploying, review the production checklist for a list of common next steps
Settings and Secrets#
App platform builds use the
You can add settings here, and use environment variables to manage any secrets, following the pattern used
throughout the file.
Environment variables can be managed in the Digital Ocean dashboard as described here.
Running One-Off Commands#
The easiest way to run once-off commands in your app is to click the “console” tab in app platform and just type in the command. See the screenshot below for what it looks like:
You may also need to run additional commands to get up and running, e.g.
for initializing your Stripe plan data.
Celery should work out-of-the box.
If you have issues running celery, ensure that you have created a Redis database, and that the values for the
REDIS_URL environment variables match the name you’ve chosen.