这是indexloc提供的服务，不要输入任何密码
Skip to content

Document remote only caching #967

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Apr 7, 2022
Merged

Document remote only caching #967

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
f8e8c20
Add docs for remote-only
gaspar09 Mar 29, 2022
66aff6a
Implement command
gaspar09 Mar 29, 2022
cc34398
Revert "Implement command"
gaspar09 Mar 29, 2022
ed5c316
Merge branch 'main' into gaspar/remote-only
gaspar09 Mar 29, 2022
cfd7984
Add docs TURBO_REMOTE_ONLY
gaspar09 Mar 29, 2022
364f224
Merge branch 'main' into gaspar/remote-only
jaredpalmer Apr 7, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 13 additions & 3 deletions docs/pages/docs/reference/command-line-reference.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ turbo run build --no-deps

Let's say you have packages A, B, C, and D where A depends on B and C depends on D. You run `turbo run build` for the first time and everything is built and cached. Then, you change a line of code in B. With the `--deps` flag on, running `turbo run build` will execute `build` in B and then A, but not in C and D because they are not impacted by the change. If you were to run `turbo run build --no-deps` instead, turbo will only run `build` in B.

#### --dry / --dry-run
#### `--dry / --dry-run`

Instead of executing tasks, display details about the affected packages and tasks that would be run.
Specify `--dry=json` to get the output in JSON format.
Expand Down Expand Up @@ -254,7 +254,7 @@ This is useful when using `--scope` in CI as it guarantees that every dependency

#### `--no-cache`

Default false. Do not cache results of the task. This is useful for watch commands like `next dev` or `react-scripts start`.
Default `false`. Do not cache results of the task. This is useful for watch commands like `next dev` or `react-scripts start`.

```shell
turbo run build --no-cache
Expand All @@ -274,7 +274,7 @@ turbo run build --output-logs=new-only

#### `--only`

Default false. Restricts execution to only include specified tasks. This is very similar to how how `lerna` or `pnpm` run tasks by default.
Default `false`. Restricts execution to only include specified tasks. This is very similar to how how `lerna` or `pnpm` run tasks by default.

Given this pipeline in `turbo.json`:

Expand Down Expand Up @@ -311,6 +311,16 @@ turbo run lint --parallel --no-cache
turbo run dev --parallel --no-cache
```

#### `--remote-only`

Default `false`. Ignore the local filesystem cache for all tasks. Only allow reading and caching artifacts using the remote cache.

```shell
turbo run build --remote-only
```

The same behavior can also be set via the `TURBO_REMOTE_ONLY=true` environment variable.

#### `--scope`

<Callout type="error">
Expand Down