App Spec docs give no indication how to create them
https://docs.digitalocean.com/products/app-platform/concepts/app-spec/ This page needs more info how to create the App Spec file. I found out later it is possible to use doctl apps spec validate , and doctl apps --spec file.yaml --upsert can be used to create/update the app, and doctl apps propose --spec file.yaml . Also the relation (or lack of) with the conventional paths of .do/app.yaml and .do/deploy.template.yaml should be explained. In my case the online UI didn't allow to detect my Dockerfile in specific location and had to use the app spec to define it. But I had very little clues on how to define the file.
Confusing statement about running "migrate" for Django apps
The Django Sample App instructions say: "Run python manage.py migrate to perform the initial database migration. You will only need to run this the very first time you deploy your app" That's confusing; wouldn't you have to run migrate every time you change the schema? And is there no way to automate that, or do you have to manually use the console for each deployment with a migration? Adding to that: you need new code to run the migration, but you also have to make sure the new code doesn't serve traffic until the migration is complete... Given all of that, it isn't clear how you'd really use App Platform to deploy a Django app in a CI/CD pipeline.
Suggestions for a few tutorials/doc pieces
Would be great to have a mention of engines/build pack docs ( https://docs.digitalocean.com/products/app-platform/reference/buildpacks/nodejs/ ) in the tutorial "Deploy a Next.js App to App Platform" ( https://docs.digitalocean.com/tutorials/app-nextjs-deploy/ ). Also, for the BuildPack docs, it would be usefull to have note of min/max version for engine fields. Had mine as 18, but build kept failing until revert to 17.