nx-remotecache-ali-oss

This is a remote caching solution for @nrwl/nx using AliCloud Object Storage.

Description

This package allows all team members and CI servers to share a single cache, improving build times and reducing resource usage. It is built with nx-remotecache-custom.

Compatibility

This package is compatible with Nx versions 16.9.0 and above.

Setup

Install the package as a dev dependency:

npm install --save-dev nx-remotecache-ali-oss

Configuration

You can configure the package using environment variables or the nx.json file. Here are the available options:

Parameter	Description	Environment Variable / .env	`nx.json`
Access Key	Connect to an AliCloud Object Storage blob via a single URL.	`NXCACHE_ALI_OSS_ACCESS_KEY`	`accessKeyId`
Access Secret Key	Use together with Account Key for AliCloud Credentials Authentication	`NXCACHE_ALI_OSS_ACCESS_KEY_SECRET`	`accessKeySecret`
Bucket	Required. Specify which container should be used for storing the cache.	`NXCACHE_ALI_OSS_BUCKET`	`bucket`
Region	Optional. Specify the location of the storage e.g. "us-west-1".	`NXCACHE_ALI_OSS_REGION`	`region`
FilePrefix	Optional. Adding file prefix before the filename.	`NXCACHE_ALI_OSS_FILE_PREFIX`	`filePrefix`

Usage

You can use this package as the default task runner in your nx.json file:

{
  "tasksRunnerOptions": {
    "default": {
      "runner": "nx-remotecache-ali-oss",
      "options": {
        "accessKeyId": "your-access-key",
        "accessKeySecret": "your-secret-key",
        "bucket": "your-bucket",
        "region": "your-region", // optional
        "filePrefix": "cache", // optional
        "cacheableOperations": ["build", "test", "lint", "e2e"]
      }
    }
  }
}