@nx/powerpack-s3-cache NPM

@nx/powerpack-s3-cache

This package is part of the Nx Powerpack extensions for Nx.

This plugin provides a Nx cache which can be self hosted on Amazon S3.

Usage

Use of this package is governed by the following LICENSE. Please be sure to read through the license carefully before using this plugin. This license is also included in the package in a LICENSE file.

Use Cases

This plugin is useful when Nx Cloud is not a viable solution. Nx Cloud is the ideal recommended method of sharing a cache between multiple machines using Nx.

This plugin uploads and downloads artifacts and metadata to and from an S3 bucket of your choice. This allows Nx to run faster in CI environments by reusing computation done in other runs.

Adding this plugin to your Nx workspace

Use nx add @nx/powerpack-s3-cache to install and setup this plugin in your Nx workspace.

Configuration

This cache can be configured in an s3 property in nx.json. The following properties are configurable:

Property	Description	Default	Required
`bucket`	The name of the S3 bucket to use for the cache.	N/a	Yes
`region`	The AWS region where the s3 bucket lives.	N/a	No
`ssoProfile`	The name of the SSO profile to use from your AWS CLI SSO Configuration.	N/a	No
`endpoint`	The endpoint where AWS can be reached.	N/a	No
`encryptionKey`	The key used to encrypt and decrypt artifacts from the cache.	N/a	No
`accessKeyId`	The access key ID for AWS.	N/a	No
`secretAccessKey`	The secret access key for AWS.	N/a	No