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.
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/
E
Eduard Gilmutdinov
John Mulhausen: Maybe it's just me, but I only noticed the link to the App Spec Reference page at the bottom of the App Spec page after reading this post :) I would be grateful if you would mention it at the beginning as well. As a suggestion, in the first sentence where you talk about the YAML manifest, "YAML manifest" could be made as a link to the App Spec Reference page, so that it won't be missed. Thank you very much!
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!