Skip to content

Commit cdfceee

Browse files
aninibreadhyperlint-ai[bot]irvinebroqueToriLindsay
authored
Builds and It's Completely Different but Also Still Build (#18955)
* outlining * Workers Builds docs revamp * pages revamp on git integration * Changes to Pages build references * small pages fixes * Update src/content/docs/workers/ci-cd/builds/index.mdx Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com> * Update src/content/docs/workers/ci-cd/builds/advanced-setups.mdx Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com> * small fix on gitlab name * fix * link fixes * link fix * small fix * add disclaimer to pages * Update src/content/docs/pages/configuration/build-caching.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/build-caching.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/build-caching.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/github-integration.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/configuration/git-integration/github-integration.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/github-integration.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/gitlab-integration.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: Brendan Irvine-Broque <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/get-started/git-integration.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/get-started/guide.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/troubleshoot.mdx Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com> * Update src/content/docs/workers/get-started/dashboard.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/build-caching.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/git-integration/github-integration.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/git-integration/gitlab-integration.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/workers/ci-cd/builds/build-caching.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/configuration/git-integration/index.mdx Co-authored-by: ToriLindsay <[email protected]> * Update src/content/docs/pages/configuration/git-integration/github-integration.mdx Co-authored-by: ToriLindsay <[email protected]> * final changes * Apply suggestions from code review Co-authored-by: ToriLindsay <[email protected]> * Apply suggestions from code review Co-authored-by: ToriLindsay <[email protected]> * final fixes * Apply suggestions from code review Co-authored-by: ToriLindsay <[email protected]> --------- Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com> Co-authored-by: Brendan Irvine-Broque <[email protected]> Co-authored-by: ToriLindsay <[email protected]>
1 parent 4e8c5b6 commit cdfceee

35 files changed

+707
-338
lines changed
140 KB
Loading
28.4 KB
Loading
107 KB
Loading
28.8 KB
Loading
39.1 KB
Loading
84.4 KB
Loading
44.7 KB
Loading

src/content/docs/pages/configuration/build-caching.mdx

Lines changed: 28 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,36 +3,17 @@ pcx_content_type: concept
33
title: Build caching
44
---
55

6-
Improve Pages build times by turning on build caching to restore dependencies and build output between builds. The first build to occur after enabling build caching on your Pages project will save to cache. Every subsequent build will restore from cache unless configured otherwise.
6+
Improve Pages build times by caching dependencies and build output between builds with a project-wide shared cache.
77

8-
## Requirements
8+
The first build to occur after enabling build caching on your Pages project will save to cache. Every subsequent build will restore from cache unless configured otherwise.
99

10-
Build caching requires the [V2 build system](/pages/configuration/build-image/#v2-build-system) or later. To update from V1, refer to the [V2 build system migration instructions](/pages/configuration/build-image/#v1-to-v2-migration).
11-
12-
## Configuration
13-
14-
### Enable build caching
15-
16-
To enable build caching in the Cloudflare dashboard:
17-
18-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
19-
2. In Account Home, select **Workers & Pages**.
20-
3. In **Overview**, select your Pages project.
21-
4. Go to **Settings** > **Build** > **Build cache** and select **Enable**.
10+
## About build cache
2211

23-
### Clear cache
24-
25-
The build cache can be cleared for a project if needed, such as when debugging build issues. To clear the build cache:
26-
27-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
28-
2. In Account Home, select **Workers & Pages**.
29-
3. In **Overview**, select your Pages project.
30-
4. Go to **Settings** > **Build** > **Build cache**.
31-
5. Select **Clear Cache** to clear the build cache.
12+
When enabled, the build cache will automatically detect and cache data from each build. Refer to [Frameworks](/pages/configuration/build-caching/#frameworks) to review what directories are automatically saved and restored from the build cache.
3213

33-
## How build caching works
14+
### Requirements
3415

35-
When enabled, the build cache will automatically detect and cache data from each build. Refer to [Frameworks](/pages/configuration/build-caching/#frameworks) to review what directories are automatically saved and restored from the build cache.
16+
Build caching requires the [V2 build system](/pages/configuration/build-image/#v2-build-system) or later. To update from V1, refer to the [V2 build system migration instructions](/pages/configuration/build-image/#v1-to-v2-migration).
3617

3718
### Package managers
3819

@@ -47,7 +28,9 @@ Pages will cache the global cache directories of the following package managers:
4728

4829
### Frameworks
4930

50-
Caching the build output from frameworks can speed up subsequent build times. The build cache supports the following frameworks:
31+
Some frameworks provide a cache directory that is typically populated by the framework with intermediate build outputs or dependencies during build time. Pages will automatically detect the framework you are using and cache this directory for reuse in subsequent builds.
32+
33+
The following frameworks support build output caching:
5134

5235
| Framework | Directories cached |
5336
| ---------- | --------------------------------------------- |
@@ -58,9 +41,27 @@ Caching the build output from frameworks can speed up subsequent build times. Th
5841
| Next.js | `.next/cache` |
5942
| Nuxt | `node_modules/.cache/nuxt` |
6043

61-
## Limits
44+
### Limits
6245

6346
The following limits are imposed for build caching:
6447

6548
- **Retention**: Cache is purged seven days after its last read date. Unread cache artifacts are purged seven days after creation.
6649
- **Storage**: Every project is allocated 10 GB. If the project cache exceeds this limit, the project will automatically start deleting artifacts that were read least recently.
50+
51+
## Enable build cache
52+
53+
To enable build caching :
54+
55+
1. Navigate to [Workers & Pages Overview](https://dash.cloudflare.com) on the Dashboard.
56+
2. Find your Pages project.
57+
3. Go to **Settings** > **Build** > **Build cache**.
58+
4. Select **Enable** to turn on build caching.
59+
60+
## Clear build cache
61+
62+
The build cache can be cleared for a project if needed, such as when debugging build issues. To clear the build cache:
63+
64+
1. Navigate to [Workers & Pages Overview](https://dash.cloudflare.com) on the Dashboard.
65+
2. Find your Pages project.
66+
3. Go to **Settings** > **Build** > **Build cache**.
67+
4. Select **Clear Cache** to clear the build cache.

src/content/docs/pages/configuration/git-integration.mdx

Lines changed: 0 additions & 128 deletions
This file was deleted.

0 commit comments

Comments
 (0)