5
App Spec docs give no indication how to create them
complete
B
Bart Verkoeijen
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.
Activity Feed
Sort by
John Mulhausen
complete
Thank you all for this feedback! We just deployed some fixes that we think will address all of this. Keep an eye on these two URLs, they're getting big updates right now:
https://docs.digitalocean.com/glossary/app-spec/
https://docs.digitalocean.com/products/app-platform/reference/app-spec/
Joe Mason
I agree completely! Docs have ZERO examples! And some docs give a few of the steps, like .do/app.yaml - but what does that mean? Where should that file be? How do we EASILY update just one or two fields in an App Spec, without major effort or without having to upload a completely new file? For that matter, what should a full ".yaml" file look like? Even the docs say, "doctl gives only basic info;" so does that mean my ".yaml" or 'get-spec' does NOT show me the full content of my file? Come on, this is June 2022, and we're missing a LOT of information that could make things MUCH easier! Even in the "App Spec UI" on your site, we go to "Edit" on the App Spec, yet there is NO EDIT - there's only "Upload" - what does that mean? How does that work? Do we have to first put a complete "app-spec.yaml" file in place, with any changed we need? This is VERY confusing & unclear!