amplify-cli
amplify-cli copied to clipboard
`amplify push` doesn't read from `backend-config`, but does read from `amplify-meta`
Describe the bug
When running amplify push I expect it to consult the backend-config.json file, especially the dependsOn array for various services.
Apparently though, running amplify env checkout … is the magic sauce to convert the items in backend-config into amplify-meta.
Amplify CLI Version 4.13.1
To Reproduce
- Make a change to your backend-config.json.
- Push to the cloud.
- Stare at your cloudformation stacks in the console, wonder why change isn't being reflected
- Deliberately break backend-config.json
- push to the cloud. not broken.
- google a bunch of things
- get frustrated
- have dinner
- come back, and repeat steps 1-7
- On a whim, look at
amplify-meta.jsonand see that while it's out of sync with yourbackend-config.jsonit's strangely in sync with what seems to be happening in the CF Template. - Finally have someone point out to you the 4th item #1 under https://aws-amplify.github.io/docs/cli-toolchain/quickstart#custom-cloudformation-stacks and see the bit about having to run
amplify env checkout …to get amplify to read the changes on your local system
Expected behavior
The build processes associated with amplify push should read backend-config in a similar fashion to how it reads all of the various cloudformation templates, schemas, functions, and everything else that're kept in source control.
Additional context I would really like to get these three hours back, but they're gone forever, sitting contently in a nice crowded room with all of the other (numerous) hours that I've lost to poorly documented, or buggy, pieces of the amplify codebase.
Preemptively sorry for my semi sarcastic tone in my steps to repro, but this was an extremely frustrating thing to find, and honestly makes no sense to me as to why it is done this way.
If there’s a compelling reason that it is the way it is, could there at least be a comment put into the backend config that it only gets read when you do an env pull?
Hi @nagey we generally don't recommend modifying those files manually. Can you give us more information on what you were trying to do?
"generally don't recommend"?

Unless you mean modifying amplify-meta, which, yeah, I get. I was trying to pipe the endpoint URL of one of the rest services into a function, rather than just the endpoints "friendly" name.
@nagey Yes, the amplify-meta.json are runtime files which should not be modified. But yes, you're right the backend-config.json has to be modified for adding custom resources/categories. And yes, as mentioned in step #4 of our documentation, we've mentioned to run amplify env checkout <env-name> after making any changes to your backend-config.json. But at the same time, I agree this could be a part of your amplify push process to make the experience better.
@kaustavghosh06 I've made sure to add the checkout step to our workflow when changing resources, but would love to hear it getting added to the amplify push
wow. thanks for this... spent hours trying to figure out why suddenly adding sns to backend-config doesn't work... lol
goes into readme: run amplify env checkout
I have had same issue today, even you don't have to go to aws console, you can see in your terminal output that there is nothing to push.
I executed amplify env checkout irfansenv and then tried amplify push again, then amplify finally asked me if I want to continue.
$ amplify -v 4.32.1
Please, please, please add it to the ' amplify push' flow. I do have a reminder to run amplify env pull before an amplify push- but I still keep forgetting about it and need more time than it should to figure out why things don't work. THANKS <3
Hi there!
This is still very much an issue. Lost hours trying to figure it out. It makes no sense that we have to run amplify env checkout every time we push. At the beginning of the amplify push, it absolutely should do that comparison and update amplify meta based on the content of the backend config.json.
Thanks
I have a custom stack to take care of assigning permissions to my Cognito user groups and Lambda functions. This issue bit me 6 months ago, today I added a new Lambda function and it bites me again. I've lost at least a day because of this...
backend-config.json is not a file developers update everyday, WHO ON EARTH WOULD REMEMBER TO RUN amplify env checkout AFTER SIX MONTHS??!!
amplify push should update amplify-meta.json automatically! Does it make sense for anyone to update backend-config.json but not want the change to take effect the next time they push? If making it fully automatic is not possible (I'd love to know why), the push command should at least check if backend-config.json has been updated and warn the user in bold red text to run checkout.
Before Amplify fixes this problem, for anyone who wants to add a reminder for themselves, you can comment in backend-config.json, for example I added the following comment to mine:
// "ALWAYS RUN `amplify env checkout <env>` AFTER UPDATING THIS FILE OR THE CHANGE WILL NOT TAKE EFFECT":
// "See: https://github.com/aws-amplify/amplify-cli/issues/3426",
{
... file content ...
}
I just burned 6 hours on similar problem, it was a badly performd merge (from a conflict) on backend-config.json that got me.
amplify push should rebuild everything and not leave some changes unbuilt.
[...] But at the same time, I agree this could be a part of your amplify push process to make the experience better.
@kaustavghosh06 any update on this? 2 years after your messages and amplify-meta.json is still not updated after amplify push
I just burned 8 hours on this issue. Can we please prioritize to update amplify-meta.json on amplify push
Is it not about this? https://github.com/aws-amplify/amplify-cli/issues/9941#issuecomment-1063231806
Here there's a solution https://github.com/aws-amplify/amplify-cli/issues/8608#issuecomment-1086890943
I just burned 8 hours on this issue. Can we please prioritize updating Worked for me @Jeevantk https://github.com/aws-amplify/amplify-cli/issues/8608#issuecomment-1086890943 amplify-meta.json on
amplify push