{"id":21381887,"url":"https://github.com/mansagroup/nx-gcs-remote-cache","last_synced_at":"2025-07-13T13:31:07.774Z","repository":{"id":36991395,"uuid":"439273126","full_name":"MansaGroup/nx-gcs-remote-cache","owner":"MansaGroup","description":"A Google Cloud Storage distributed cache plugin for Nx.","archived":false,"fork":false,"pushed_at":"2023-07-06T20:57:01.000Z","size":2769,"stargazers_count":12,"open_issues_count":5,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-25T13:40:44.621Z","etag":null,"topics":["cache","distributed","gcp","gcs","google-cloud-platform","google-cloud-storage","monorepo","nrwl","nx"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MansaGroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-17T09:09:13.000Z","updated_at":"2024-02-20T05:51:45.000Z","dependencies_parsed_at":"2023-01-17T12:00:57.344Z","dependency_job_id":null,"html_url":"https://github.com/MansaGroup/nx-gcs-remote-cache","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MansaGroup%2Fnx-gcs-remote-cache","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MansaGroup%2Fnx-gcs-remote-cache/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MansaGroup%2Fnx-gcs-remote-cache/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MansaGroup%2Fnx-gcs-remote-cache/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MansaGroup","download_url":"https://codeload.github.com/MansaGroup/nx-gcs-remote-cache/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225885502,"owners_count":17539640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cache","distributed","gcp","gcs","google-cloud-platform","google-cloud-storage","monorepo","nrwl","nx"],"created_at":"2024-11-22T10:49:56.400Z","updated_at":"2024-11-22T10:49:57.048Z","avatar_url":"https://github.com/MansaGroup.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Banner](.github/assets/banner-thin.png)\n\n# nx-gcs-remote-cache\n\n![License](https://img.shields.io/github/license/MansaGroup/nx-gcs-remote-cache?style=flat-square) ![GitHub Issues](https://img.shields.io/github/issues/mansagroup/nx-gcs-remote-cache?style=flat-square) ![GitHub Stars](https://img.shields.io/github/stars/MansaGroup/nx-gcs-remote-cache?style=flat-square)\n\nThis package implements a Google Cloud Storage-backed distributed cache for\n[Nrwl Nx](https://nx.dev/) monorepos.\n\nThe distributed cache allows one or more developpers, including CI/CD\npipelines to share the same task cache, allowing one to not run a task\nalready ran by someone else when the code did not changed.\n\n\u003e Nx provides Nx Cloud, a SaaS allowing you and your team to have a\n\u003e distributed cache and task runner to avoid the hassle of having\n\u003e your computer to burn when building your entire monorepo.\n\nThis plugin **only** provides a distributed cache implementation, not\na task runner alternative.\n\n## Usage\n\nEven if this plugin is installed in your workspace, the GCS cache is\nopt-in by default. If the `NX_REMOTE_CACHE_BUCKET` environment variable\nrequired is not found, this plugin will fallback to the default behavior\nyou already know.\n\nTo add this plugin to your workspace, please install the package from\nnpm using your favorite package manager:\n\n```bash\n# Install the package\nnpm install --save-dev @mansagroup/nx-gcs-remote-cache\n```\n\nThen, change your task runner for the one provided by the plugin in your\n`nx.json` file:\n\n```js\n{\n  \"tasksRunnerOptions\": {\n    \"default\": {\n      \"runner\": \"@mansagroup/nx-gcs-remote-cache\"\n    }\n  }\n}\n```\n\nFinally, set your `NX_REMOTE_CACHE_BUCKET` environment variable to the name\nof your Google Cloud Storage bucket to use as cache container.\n\n\u003e This plugin consider that you've already configured your Google Cloud CLI,\n\u003e especially the application default credentials using\n\u003e `gcloud auth application-default login` if you work locally. The procedure\n\u003e for an automated environment such as a CI/CD can differ.\n\n## License\n\nThis project is [MIT licensed](LICENSE.txt).\n\n## Contributors\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://jeremylvln.fr/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/6763873?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJérémy Levilain\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/MansaGroup/nx-gcs-remote-cache/commits?author=IamBlueSlime\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#ideas-IamBlueSlime\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmansagroup%2Fnx-gcs-remote-cache","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmansagroup%2Fnx-gcs-remote-cache","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmansagroup%2Fnx-gcs-remote-cache/lists"}