Skip to content

Update build image docs #28479

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
yomna-shousha wants to merge 2 commits into from
+20 −23
Closed

Update build image docs #28479

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c185bda
[Pages] Update build image docs to clarify supported version ranges
yomna-shousha Feb 20, 2026
57728fa
[Workers] Update build image docs to match actual versions
yomna-shousha Feb 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 2 additions & 6 deletions src/content/docs/pages/configuration/build-image.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,14 @@

<PagesBuildEnvironmentLanguages />

:::note[Any version]
Under Supported versions, "Any version" refers to support for all versions of the language or tool including versions newer than the Default version.
:::note[Supported versions]
For v2 and v3, "Any version up to X.Y.Z" indicates the maximum version available in the build image. Newer versions released after the build image was last updated may not be supported until the next update.
:::

### Tools

<PagesBuildEnvironmentTools />

:::note[Any version]
Under Supported versions, "Any version" refers to support for all versions of the language or tool including versions newer than the Default version.
:::

### Frameworks

To use a specific version of a framework, specify it in the project's package manager configuration file.
Expand Down Expand Up @@ -76,7 +72,7 @@

## v3 build system

The v3 build system updates the default tools, libraries and languages to their LTS versions, as of May 2025.

Check warning on line 75 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-year 

Potential year found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

Check warning on line 75 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month 

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

### v2 to v3 Migration

Expand Down Expand Up @@ -113,8 +109,8 @@

If you are currently using the v1 or v2 build image, your project will be automatically moved to v3:

- **v1 build image**: If you are using the Pages v1 build image, your project will be automatically moved to v3 on August 25, 2026.

Check warning on line 112 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-year 

Potential year found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

Check warning on line 112 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month 

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)
- **v2 build image**: If you are using the Pages v2 build image, your project will be automatically moved to v3 on February 23, 2027.

Check warning on line 113 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-year 

Potential year found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

Check warning on line 113 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month 

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

You will receive 6 months’ notice before the deprecation date via the [Cloudflare Changelog](https://developers.cloudflare.com/changelog/), dashboard notifications, and email.

Expand All @@ -124,7 +120,7 @@

Preinstalled software (languages and tools) will be updated before reaching end-of-life (EOL). These updates apply only if you have not [overridden the default version](/pages/configuration/build-image/#override-default-versions).

- **Minor version updates**: May be updated to the latest available minor version without notice. For tools that do not follow semantic versioning (e.g., Bun or Hugo), updates that may contain breaking changes will receive 3 months’ notice.

Check warning on line 123 in src/content/docs/pages/configuration/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month 

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)
- **Major version updates**: Updated to the next stable long-term support (LTS) version with 3 months’ notice.

**How you'll be notified (for changes requiring notice):**
Expand Down
3 changes: 2 additions & 1 deletion src/content/docs/workers/ci-cd/builds/build-image.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
| **Go** | 1.24.3 | `GO_VERSION` | |
| **Node.js** | 22.16.0 | `NODE_VERSION` | .nvmrc, .node-version |
| **Python** | 3.13.3 | `PYTHON_VERSION` | .python-version, runtime.txt |
| **Ruby** | 3.4.4 | `RUBY_VERSION` | .ruby-version |
| **Ruby** | 3.4.7 | `RUBY_VERSION` | .ruby-version |

### Tools and languages

Expand All @@ -38,6 +38,7 @@
| **gem** | 3.6.9 | |
| **poetry** | 2.1.3 | |
| **pipx** | 1.7.1 | |
| **uv** | 0.7.13 | |
| **bundler** | 2.6.9 | |

## Advanced Settings
Expand Down Expand Up @@ -96,7 +97,7 @@

Preinstalled software (languages and tools) will be updated before reaching end-of-life (EOL). These updates apply only if you have not [overridden the default version](/workers/ci-cd/builds/build-image/#overriding-default-versions).

- **Minor version updates**: May be updated to the latest available minor version without notice. For tools that do not follow semantic versioning (e.g., Bun or Hugo), updates that may contain breaking changes will receive 3 months’ notice.

Check warning on line 100 in src/content/docs/workers/ci-cd/builds/build-image.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month 

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)
- **Major version updates**: Updated to the next stable long-term support (LTS) version with 3 months’ notice.

**How you'll be notified (for changes requiring notice):**
Expand Down
16 changes: 8 additions & 8 deletions src/content/pages-build-environment/v2.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,29 +3,29 @@ enable_date: "2023-05-17"
languages:
- name: Go
default: "1.21.0"
supported: "Any version"
supported: "Any version up to 1.26.0"
environment_variable: "GO_VERSION"
- name: Node.js
default: "18.17.1"
supported: "Any version"
supported: "Any version up to 25.6.1"
environment_variable: "NODE_VERSION"
file:
- ".nvmrc"
- ".node-version"
- name: Bun
default: "1.1.33"
supported: "Any version"
supported: "Any version up to 1.3.9"
environment_variable: "BUN_VERSION"
- name: Python
default: "3.11.5"
supported: "Any version"
supported: "Any version up to 3.14.3"
environment_variable: "PYTHON_VERSION"
file:
- ".python-version"
- "runtime.txt"
- name: Ruby
default: "3.2.2"
supported: "Any version"
supported: "Any version up to 3.4.4"
environment_variable: "RUBY_VERSION"
file:
- ".ruby-version"
Expand All @@ -42,7 +42,7 @@ tools:
supported: "Corresponds with Ruby version"
- name: Hugo
default: "0.118.2"
supported: "Any version"
supported: "Any version up to 0.155.3"
environment_variable: "HUGO_VERSION"
- name: npm
default: "9.6.7"
Expand All @@ -54,13 +54,13 @@ tools:
default: "1.2.0"
- name: pnpm
default: "8.7.1"
supported: "Any version"
supported: "Any version up to 10.29.3"
environment_variable: "PNPM_VERSION"
- name: Poetry
default: "1.6.1"
- name: Yarn
default: "3.6.3"
supported: "Any version"
supported: "Any version up to 4.12.0"
environment_variable: "YARN_VERSION"
build_environment:
operating_system: "Ubuntu `22.04.2`"
Expand Down
16 changes: 8 additions & 8 deletions src/content/pages-build-environment/v3.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,29 +3,29 @@ enable_date: "2025-05-30"
languages:
- name: Go
default: "1.24.3"
supported: "Any version"
supported: "Any version up to 1.26.0"
environment_variable: "GO_VERSION"
- name: Node.js
default: "22.16.0"
supported: "Any version"
supported: "Any version up to 25.6.1"
environment_variable: "NODE_VERSION"
file:
- ".nvmrc"
- ".node-version"
- name: Bun
default: "1.2.15"
supported: "Any version"
supported: "Any version up to 1.3.9"
environment_variable: "BUN_VERSION"
- name: Python
default: "3.13.3"
supported: "Any version"
supported: "Any version up to 3.14.3"
environment_variable: "PYTHON_VERSION"
file:
- ".python-version"
- "runtime.txt"
- name: Ruby
default: "3.4.4"
supported: "Any version"
supported: "Any version up to 3.4.4"
environment_variable: "RUBY_VERSION"
file:
- ".ruby-version"
Expand All @@ -42,7 +42,7 @@ tools:
supported: "Corresponds with Ruby version"
- name: Hugo
default: "0.147.7"
supported: "Any version"
supported: "Any version up to 0.155.3"
environment_variable: "HUGO_VERSION"
- name: npm
default: "10.9.2"
Expand All @@ -54,13 +54,13 @@ tools:
default: "1.7.1"
- name: pnpm
default: "10.11.1"
supported: "Any version"
supported: "Any version up to 10.29.3"
environment_variable: "PNPM_VERSION"
- name: Poetry
default: "2.1.3"
- name: Yarn
default: "4.9.1"
supported: "Any version"
supported: "Any version up to 4.12.0"
environment_variable: "YARN_VERSION"
build_environment:
operating_system: "Ubuntu `22.04.2`"
Expand Down
Loading