CodeDeploy bundles must have appspec.yml at the root of the archive. A common mistake is creating the zip from outside the project directory (e.g., zip -r bundle.zip myproject/) which produces an archive whose top entry is myproject/appspec.yml — the agent cannot find it because it expects ./appspec.yml. The fix is to cd into the project directory and run zip -r bundle.zip . (or use aws deploy push, which packages correctly). The same applies for tar.gz bundles.

Plain-Language Explanation:

It is like submitting forms in an envelope. CodeDeploy expects to open the envelope and see the cover sheet (appspec.yml) on top. If the cover sheet is hidden inside another envelope (a wrapping directory), the receiving clerk says 'no cover sheet found' even though the form is inside.

Option Analysis:788

A：Correct. appspec.yml must sit at the bundle's archive root with no wrapping directory.
B：SSM permissions are unrelated.
C：Agent version is unrelated.
D：Folder naming inside the bundle is up to the bundle author.