e4f5224e9e
<!-- Please make sure you have read the submission guidelines before posting an PR --> <!-- https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr --> <!-- Please make sure that your commit message follows our format --> <!-- Example: `fix(nx): must begin with lowercase` --> <!-- If this is a particularly complex change or feature addition, you can request a dedicated Nx release for this pull request branch. Mention someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they will confirm if the PR warrants its own release for testing purposes, and generate it for you if appropriate. --> ## Current Behavior Cache artifacts are removed based on age at a random interval. There is not a way to set a max size for the cache, so it can grow quite large in certain repos ## Expected Behavior Cache size can be controlled via `maxCacheSize` in `nx.json`. Cache artifacts are removed based on usage until the limit has been reached. ## Related Issue(s) <!-- Please link the issue being fixed so it gets closed when this is merged. --> Fixes # --------- Co-authored-by: FrozenPandaz <jasonjean1993@gmail.com>
464 lines
13 KiB
Markdown
464 lines
13 KiB
Markdown
# Interface: Workspace
|
|
|
|
**`Deprecated`**
|
|
|
|
use ProjectsConfigurations or NxJsonConfiguration
|
|
|
|
## Hierarchy
|
|
|
|
- [`ProjectsConfigurations`](../../devkit/documents/ProjectsConfigurations)
|
|
|
|
- [`NxJsonConfiguration`](../../devkit/documents/NxJsonConfiguration)
|
|
|
|
↳ **`Workspace`**
|
|
|
|
## Table of contents
|
|
|
|
### Properties
|
|
|
|
- [$schema](../../devkit/documents/Workspace#$schema): string
|
|
- [affected](../../devkit/documents/Workspace#affected): NxAffectedConfig
|
|
- [cacheDirectory](../../devkit/documents/Workspace#cachedirectory): string
|
|
- [cli](../../devkit/documents/Workspace#cli): Object
|
|
- [defaultBase](../../devkit/documents/Workspace#defaultbase): string
|
|
- [defaultProject](../../devkit/documents/Workspace#defaultproject): string
|
|
- [extends](../../devkit/documents/Workspace#extends): string
|
|
- [generators](../../devkit/documents/Workspace#generators): Object
|
|
- [implicitDependencies](../../devkit/documents/Workspace#implicitdependencies): ImplicitDependencyEntry<string[] | "\*">
|
|
- [installation](../../devkit/documents/Workspace#installation): NxInstallationConfiguration
|
|
- [maxCacheSize](../../devkit/documents/Workspace#maxcachesize): string
|
|
- [namedInputs](../../devkit/documents/Workspace#namedinputs): Object
|
|
- [neverConnectToCloud](../../devkit/documents/Workspace#neverconnecttocloud): boolean
|
|
- [nxCloudAccessToken](../../devkit/documents/Workspace#nxcloudaccesstoken): string
|
|
- [nxCloudEncryptionKey](../../devkit/documents/Workspace#nxcloudencryptionkey): string
|
|
- [nxCloudId](../../devkit/documents/Workspace#nxcloudid): string
|
|
- [nxCloudUrl](../../devkit/documents/Workspace#nxcloudurl): string
|
|
- [parallel](../../devkit/documents/Workspace#parallel): number
|
|
- [plugins](../../devkit/documents/Workspace#plugins): PluginConfiguration[]
|
|
- [pluginsConfig](../../devkit/documents/Workspace#pluginsconfig): Record<string, Record<string, unknown>>
|
|
- [projects](../../devkit/documents/Workspace#projects): Record<string, ProjectConfiguration>
|
|
- [release](../../devkit/documents/Workspace#release): NxReleaseConfiguration
|
|
- [sync](../../devkit/documents/Workspace#sync): NxSyncConfiguration
|
|
- [targetDefaults](../../devkit/documents/Workspace#targetdefaults): TargetDefaults
|
|
- [tasksRunnerOptions](../../devkit/documents/Workspace#tasksrunneroptions): Object
|
|
- [useDaemonProcess](../../devkit/documents/Workspace#usedaemonprocess): boolean
|
|
- [useInferencePlugins](../../devkit/documents/Workspace#useinferenceplugins): boolean
|
|
- [useLegacyCache](../../devkit/documents/Workspace#uselegacycache): boolean
|
|
- [version](../../devkit/documents/Workspace#version): number
|
|
- [workspaceLayout](../../devkit/documents/Workspace#workspacelayout): Object
|
|
|
|
## Properties
|
|
|
|
### $schema
|
|
|
|
• `Optional` **$schema**: `string`
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[$schema](../../devkit/documents/NxJsonConfiguration#$schema)
|
|
|
|
---
|
|
|
|
### affected
|
|
|
|
• `Optional` **affected**: [`NxAffectedConfig`](../../devkit/documents/NxAffectedConfig)
|
|
|
|
Default options for `nx affected`
|
|
|
|
**`Deprecated`**
|
|
|
|
use [defaultBase](../../devkit/documents/NxJsonConfiguration#defaultbase) instead. For more information see https://nx.dev/deprecated/affected-config#affected-config
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[affected](../../devkit/documents/NxJsonConfiguration#affected)
|
|
|
|
---
|
|
|
|
### cacheDirectory
|
|
|
|
• `Optional` **cacheDirectory**: `string`
|
|
|
|
Changes the directory used by Nx to store its cache.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[cacheDirectory](../../devkit/documents/NxJsonConfiguration#cachedirectory)
|
|
|
|
---
|
|
|
|
### cli
|
|
|
|
• `Optional` **cli**: `Object`
|
|
|
|
Default generator collection. It is used when no collection is provided.
|
|
|
|
#### Type declaration
|
|
|
|
| Name | Type |
|
|
| :-------------------- | :-------------------------------------------------------- |
|
|
| `defaultProjectName?` | `string` |
|
|
| `packageManager?` | [`PackageManager`](../../devkit/documents/PackageManager) |
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[cli](../../devkit/documents/NxJsonConfiguration#cli)
|
|
|
|
---
|
|
|
|
### defaultBase
|
|
|
|
• `Optional` **defaultBase**: `string`
|
|
|
|
Default value for --base used by `nx affected` and `nx format`.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[defaultBase](../../devkit/documents/NxJsonConfiguration#defaultbase)
|
|
|
|
---
|
|
|
|
### defaultProject
|
|
|
|
• `Optional` **defaultProject**: `string`
|
|
|
|
Default project. When project isn't provided, the default project
|
|
will be used. Convenient for small workspaces with one main application.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[defaultProject](../../devkit/documents/NxJsonConfiguration#defaultproject)
|
|
|
|
---
|
|
|
|
### extends
|
|
|
|
• `Optional` **extends**: `string`
|
|
|
|
Optional (additional) Nx.json configuration file which becomes a base for this one
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[extends](../../devkit/documents/NxJsonConfiguration#extends)
|
|
|
|
---
|
|
|
|
### generators
|
|
|
|
• `Optional` **generators**: `Object`
|
|
|
|
List of default values used by generators.
|
|
|
|
These defaults are global. They are used when no other defaults are configured.
|
|
|
|
Example:
|
|
|
|
```
|
|
{
|
|
"@nx/react": {
|
|
"library": {
|
|
"style": "scss"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
#### Index signature
|
|
|
|
▪ [collectionName: `string`]: \{ `[generatorName: string]`: `any`; }
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[generators](../../devkit/documents/NxJsonConfiguration#generators)
|
|
|
|
---
|
|
|
|
### implicitDependencies
|
|
|
|
• `Optional` **implicitDependencies**: [`ImplicitDependencyEntry`](../../devkit/documents/ImplicitDependencyEntry)\<`string`[] \| `"*"`\>
|
|
|
|
Map of files to projects that implicitly depend on them
|
|
|
|
**`Deprecated`**
|
|
|
|
use [namedInputs](../../devkit/documents/NxJsonConfiguration#namedinputs) instead. For more information see https://nx.dev/deprecated/global-implicit-dependencies#global-implicit-dependencies
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[implicitDependencies](../../devkit/documents/NxJsonConfiguration#implicitdependencies)
|
|
|
|
---
|
|
|
|
### installation
|
|
|
|
• `Optional` **installation**: `NxInstallationConfiguration`
|
|
|
|
Configures the Nx installation for a repo. Useful for maintaining a separate
|
|
set of dependencies for Nx + Plugins compared to the base package.json, but also
|
|
useful for workspaces that don't have a root package.json + node_modules.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[installation](../../devkit/documents/NxJsonConfiguration#installation)
|
|
|
|
---
|
|
|
|
### maxCacheSize
|
|
|
|
• `Optional` **maxCacheSize**: `string`
|
|
|
|
Sets the maximum size of the local cache. Accepts a number followed by a unit (e.g. 100MB). Accepted units are B, KB, MB, and GB.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[maxCacheSize](../../devkit/documents/NxJsonConfiguration#maxcachesize)
|
|
|
|
---
|
|
|
|
### namedInputs
|
|
|
|
• `Optional` **namedInputs**: `Object`
|
|
|
|
Named inputs targets can refer to reduce duplication
|
|
|
|
#### Index signature
|
|
|
|
▪ [inputName: `string`]: (`string` \| `InputDefinition`)[]
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[namedInputs](../../devkit/documents/NxJsonConfiguration#namedinputs)
|
|
|
|
---
|
|
|
|
### neverConnectToCloud
|
|
|
|
• `Optional` **neverConnectToCloud**: `boolean`
|
|
|
|
Set this to true to disable connection to Nx Cloud
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[neverConnectToCloud](../../devkit/documents/NxJsonConfiguration#neverconnecttocloud)
|
|
|
|
---
|
|
|
|
### nxCloudAccessToken
|
|
|
|
• `Optional` **nxCloudAccessToken**: `string`
|
|
|
|
If specified Nx will use nx-cloud by default with the given token.
|
|
To use a different runner that accepts an access token, define it in [tasksRunnerOptions](../../devkit/documents/NxJsonConfiguration#tasksrunneroptions)
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[nxCloudAccessToken](../../devkit/documents/NxJsonConfiguration#nxcloudaccesstoken)
|
|
|
|
---
|
|
|
|
### nxCloudEncryptionKey
|
|
|
|
• `Optional` **nxCloudEncryptionKey**: `string`
|
|
|
|
Specifies the encryption key used to encrypt artifacts data before sending it to nx cloud.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[nxCloudEncryptionKey](../../devkit/documents/NxJsonConfiguration#nxcloudencryptionkey)
|
|
|
|
---
|
|
|
|
### nxCloudId
|
|
|
|
• `Optional` **nxCloudId**: `string`
|
|
|
|
If specified Nx will use nx-cloud by default with the given cloud id.
|
|
To use a different runner that accepts a cloud id, define it in [tasksRunnerOptions](../../devkit/documents/NxJsonConfiguration#tasksrunneroptions)
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[nxCloudId](../../devkit/documents/NxJsonConfiguration#nxcloudid)
|
|
|
|
---
|
|
|
|
### nxCloudUrl
|
|
|
|
• `Optional` **nxCloudUrl**: `string`
|
|
|
|
Specifies the url pointing to an instance of nx cloud. Used for remote
|
|
caching and displaying run links.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[nxCloudUrl](../../devkit/documents/NxJsonConfiguration#nxcloudurl)
|
|
|
|
---
|
|
|
|
### parallel
|
|
|
|
• `Optional` **parallel**: `number`
|
|
|
|
Specifies how many tasks can be run in parallel.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[parallel](../../devkit/documents/NxJsonConfiguration#parallel)
|
|
|
|
---
|
|
|
|
### plugins
|
|
|
|
• `Optional` **plugins**: [`PluginConfiguration`](../../devkit/documents/PluginConfiguration)[]
|
|
|
|
Plugins for extending the project graph
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[plugins](../../devkit/documents/NxJsonConfiguration#plugins)
|
|
|
|
---
|
|
|
|
### pluginsConfig
|
|
|
|
• `Optional` **pluginsConfig**: `Record`\<`string`, `Record`\<`string`, `unknown`\>\>
|
|
|
|
Configuration for Nx Plugins
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[pluginsConfig](../../devkit/documents/NxJsonConfiguration#pluginsconfig)
|
|
|
|
---
|
|
|
|
### projects
|
|
|
|
• **projects**: `Record`\<`string`, [`ProjectConfiguration`](../../devkit/documents/ProjectConfiguration)\>
|
|
|
|
Projects' projects
|
|
|
|
#### Overrides
|
|
|
|
[ProjectsConfigurations](../../devkit/documents/ProjectsConfigurations).[projects](../../devkit/documents/ProjectsConfigurations#projects)
|
|
|
|
---
|
|
|
|
### release
|
|
|
|
• `Optional` **release**: `NxReleaseConfiguration`
|
|
|
|
Configuration for `nx release` (versioning and publishing of applications and libraries)
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[release](../../devkit/documents/NxJsonConfiguration#release)
|
|
|
|
---
|
|
|
|
### sync
|
|
|
|
• `Optional` **sync**: `NxSyncConfiguration`
|
|
|
|
Configuration for the `nx sync` command.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[sync](../../devkit/documents/NxJsonConfiguration#sync)
|
|
|
|
---
|
|
|
|
### targetDefaults
|
|
|
|
• `Optional` **targetDefaults**: [`TargetDefaults`](../../devkit/documents/TargetDefaults)
|
|
|
|
Dependencies between different target names across all projects
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[targetDefaults](../../devkit/documents/NxJsonConfiguration#targetdefaults)
|
|
|
|
---
|
|
|
|
### tasksRunnerOptions
|
|
|
|
• `Optional` **tasksRunnerOptions**: `Object`
|
|
|
|
**`Deprecated`**
|
|
|
|
Custom task runners will be replaced by a new API starting with Nx 21. More info: https://nx.dev/deprecated/custom-tasks-runner
|
|
Available Task Runners for Nx to use
|
|
|
|
#### Index signature
|
|
|
|
▪ [tasksRunnerName: `string`]: \{ `options?`: `any` ; `runner?`: `string` }
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[tasksRunnerOptions](../../devkit/documents/NxJsonConfiguration#tasksrunneroptions)
|
|
|
|
---
|
|
|
|
### useDaemonProcess
|
|
|
|
• `Optional` **useDaemonProcess**: `boolean`
|
|
|
|
Set this to false to disable the daemon.
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[useDaemonProcess](../../devkit/documents/NxJsonConfiguration#usedaemonprocess)
|
|
|
|
---
|
|
|
|
### useInferencePlugins
|
|
|
|
• `Optional` **useInferencePlugins**: `boolean`
|
|
|
|
Set this to false to disable adding inference plugins when generating new projects
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[useInferencePlugins](../../devkit/documents/NxJsonConfiguration#useinferenceplugins)
|
|
|
|
---
|
|
|
|
### useLegacyCache
|
|
|
|
• `Optional` **useLegacyCache**: `boolean`
|
|
|
|
Use the legacy file system cache instead of the db cache
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[useLegacyCache](../../devkit/documents/NxJsonConfiguration#uselegacycache)
|
|
|
|
---
|
|
|
|
### version
|
|
|
|
• **version**: `number`
|
|
|
|
Version of the configuration format
|
|
|
|
#### Inherited from
|
|
|
|
[ProjectsConfigurations](../../devkit/documents/ProjectsConfigurations).[version](../../devkit/documents/ProjectsConfigurations#version)
|
|
|
|
---
|
|
|
|
### workspaceLayout
|
|
|
|
• `Optional` **workspaceLayout**: `Object`
|
|
|
|
Where new apps + libs should be placed
|
|
|
|
#### Type declaration
|
|
|
|
| Name | Type |
|
|
| :--------- | :------- |
|
|
| `appsDir?` | `string` |
|
|
| `libsDir?` | `string` |
|
|
|
|
#### Inherited from
|
|
|
|
[NxJsonConfiguration](../../devkit/documents/NxJsonConfiguration).[workspaceLayout](../../devkit/documents/NxJsonConfiguration#workspacelayout)
|