Skip to content

Commit a1bb5a5

Browse files
committed
docs: deploy build path flags, config file auto-detection
Documents --native-build, --depot-build, --local-bundle, --detach and --build-logs in the deploy command reference, updates the GitHub integration's config file setting to describe auto-detection, and points the resource_exhausted troubleshooting entry at the --native-build flag.
1 parent 43ecf15 commit a1bb5a5

3 files changed

Lines changed: 26 additions & 2 deletions

File tree

docs/github-integration.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ This eliminates the need to manually run the `trigger.dev deploy` command or set
3434
<Step title="Customize build settings (optional)">
3535
Configure how your project is built:
3636

37-
- **Trigger config file**: Path to your `trigger.config.ts` file. By default, we look for it in the root of your repository. The path should be relative to the root of your repository and contain the config file name, e.g., `apps/tasks/trigger.config.ts`.
37+
- **Trigger config file**: Auto-detected by default — we find your `trigger.config.ts` anywhere in your repository. Set a path relative to the root of your repository to override it, e.g., `apps/tasks/trigger.config.ts`. If your repository contains more than one config file, set the path of the one to use.
3838
- **Install command**: Auto-detected by default, but you can override it if necessary. The command will be run from the root of your repository.
3939
- **Pre-build command**: Run any commands before building and deploying your project, e.g., `pnpm run prisma:generate`. The command will be run from the root of your repository.
4040
</Step>

docs/snippets/cli-commands-deploy.mdx

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,30 @@ npx trigger.dev@latest deploy [path]
9898
briefly before it notices. Requires `--external-id`.
9999
</ParamField>
100100

101+
<ParamField body="Native build" type="--native-build">
102+
Build the image on the Trigger.dev build server. Without a build flag, the server picks the build
103+
path for your project.
104+
</ParamField>
105+
106+
<ParamField body="Depot build" type="--depot-build">
107+
Build the image with Depot, ignoring any build path configured on the server.
108+
</ParamField>
109+
110+
<ParamField body="Local bundle" type="--local-bundle">
111+
Install and bundle on your machine, then build the image on the build server from the uploaded
112+
bundle. Requires `--native-build`.
113+
</ParamField>
114+
115+
<ParamField body="Detach" type="--detach">
116+
Exit once the build is queued instead of streaming the build logs. The deployment continues on
117+
the build server. Requires `--native-build`.
118+
</ParamField>
119+
120+
<ParamField body="Build logs" type="--build-logs">
121+
How build logs are shown: `compact` (default, a single updating line) or `full` (every log line).
122+
CI and piped output always use `full`.
123+
</ParamField>
124+
101125
<ParamField body="Local build" type="--local-build">
102126
Force building the deployment image locally using your local Docker. This is automatic when self-hosting.
103127
</ParamField>

docs/troubleshooting.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ Usually there will be some useful guidance below this message. If you can't figu
8787

8888
### `resource_exhausted`
8989

90-
If you see a `resource_exhausted` error during deploy, the build may have hit resource limits on our build infrastructure. Try our [native builder](https://trigger.dev/changelog/deployments-with-native-builds).
90+
If you see a `resource_exhausted` error during deploy, the build may have hit resource limits on our build infrastructure. Try our [native builder](https://trigger.dev/changelog/deployments-with-native-builds) by deploying with the `--native-build` flag.
9191

9292
### `No loader is configured for ".node" files`
9393

0 commit comments

Comments
 (0)