Skip to content

Commit e89a47d

Browse files
Update deployment-helper-troubleshooting.md
1 parent 46d7437 commit e89a47d

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

guides/hosting/installation-updates/deployments/deployment-helper-troubleshooting.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,17 @@ vendor/bin/shopware-deployment-helper run --timeout=null
3939

4040
You can also set `SHOPWARE_DEPLOYMENT_TIMEOUT` in the environment. The `--timeout` option takes precedence.
4141

42-
## Theme or asset steps are slow or redundant in CI/CD
42+
## Theme and assets were not pre-built in CI/CD
4343

44-
If your CI build already compiled the theme and installed assets (via `shopware-cli project ci`), skip those steps at deploy time:
44+
The deployment artifact must already contain the compiled theme and installed assets. In CI/CD, build the artifact with `shopware-cli project ci` and deploy that output.
45+
46+
At deploy time, run Deployment Helper with the theme and asset steps skipped so it only consumes the pre-built artifact:
4547

4648
```bash
4749
vendor/bin/shopware-deployment-helper run --skip-theme-compile --skip-assets-install
4850
```
4951

50-
Only skip them if the build genuinely produced them. Otherwise, the storefront will be missing compiled assets.
52+
If the Storefront is missing assets after deployment, fix the CI build artifact or upload step. Do not compensate by compiling the theme or installing assets during deployment.
5153

5254
## An update ran, but `system:update:finish` did not
5355

0 commit comments

Comments
 (0)