Skip to content

Commit e754a45

Browse files
committed
docs: update example versions
1 parent 0cb8e53 commit e754a45

File tree

6 files changed

+36
-38
lines changed

6 files changed

+36
-38
lines changed

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ Once the PR is merged into the `master` branch, the corresponding images will be
7777
7878
If you need to release alternate versions that do not qualify to be primary versions, do not modify the contents of the [factory/.env](./factory/.env) file in the `master` branch. An example would be to publish images including updated [Node.js releases](https://nodejs.org/en/about/previous-releases) in the category "Maintenance LTS" or "Current". Instead, carry out the following steps:
7979

80-
1. Create a feature branch in the form `<cypress-version>-node-<node.js version>-publish`, for example `13.11.0-node-18.20.3-publish`, branched from the `master` branch. If you are not a member of the Cypress org, make a request via a new issue to create a feature branch.
80+
1. Create a feature branch in the form `<cypress-version>-node-<node.js version>-publish`, for example `15.1.0-node-20.19.4-publish`, branched from the `master` branch. If you are not a member of the Cypress org, make a request via a new issue to create a feature branch.
8181
2. Modify [factory/.env](./factory/.env) with the desired versions. Do not modify the `FACTORY_VERSION`. No new `cypress/factory` image should be published with this process.
8282
3. Modify [factory/docker-compose.yml](./factory/docker-compose.yml) to comment out the creation of `latest` tags. Comment out the `cypress/included` `INCLUDED_IMAGE_SHORT_TAG` to also prevent this tag from being created. This step is essential to avoid the related tags of any existing released images being moved to point to non-primary images.
8383
4. Modify [circle.yml](circle.yml) to push releases from the feature branch.

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -93,17 +93,17 @@ For each of the `REPOSITORY` image types, see the `Tags` section of each `README
9393

9494
| Image Type README | Example Tag |
9595
| ---------------------------------------------------- | ----------- |
96-
| [cypress/factory README](./factory/README.md#tags) | `5.1.0` |
97-
| [cypress/base README](./base/README.md#tags) | `22.11.0` |
98-
| [cypress/browsers README](./browsers/README.md#tags) | `22.11.0` |
99-
| [cypress/included README](./included/README.md#tags) | `13.16.0` |
96+
| [cypress/factory README](./factory/README.md#tags) | `6.0.1` |
97+
| [cypress/base README](./base/README.md#tags) | `22.19.0` |
98+
| [cypress/browsers README](./browsers/README.md#tags) | `22.19.0` |
99+
| [cypress/included README](./included/README.md#tags) | `15.1.0` |
100100

101-
Images with a specific version tag for `cypress/factory` and `cypress/base` (for example: `cypress/factory:5.1.0` and `cypress/base:22.11.0`) are frozen once they have been published. The same is true for images linked to full browser version tags for `cypress/browsers` and `cypress/included` (for example: `cypress/browsers:node-22.11.0-chrome-131.0.6778.69-1-ff-132.0.2-edge-131.0.2903.51-1` and `cypress/included:cypress-13.16.0-node-22.11.0-chrome-131.0.6778.69-1-ff-132.0.2-edge-131.0.2903.51-1`).
101+
Images with a specific version tag for `cypress/factory` and `cypress/base` (for example: `cypress/factory:6.0.1` and `cypress/base:22.19.0`) are frozen once they have been published. The same is true for images linked to full browser version tags for `cypress/browsers` and `cypress/included` (for example: `cypress/browsers:node-22.19.0-chrome-139.0.7258.154-1-ff-142.0.1-edge-139.0.3405.125-1` and `cypress/included:cypress-15.1.0-node-22.19.0-chrome-139.0.7258.154-1-ff-142.0.1-edge-139.0.3405.125-1`).
102102

103103
The version tags for Chrome and Edge for `Linux/arm64` images, as well as Firefox version tags below `ff-136.x`, do not carry any meaning due to browser unavailability for this platform.
104104
With the tag scheme used by Cypress Docker images, all tags are required to be in place to allow use of Docker's [multi-platform images](https://docs.docker.com/build/building/multi-platform/), irrespective of whether the browser is actually available or not.
105105

106-
`cypress/browsers` and `cypress/included` images are also offered with short-form convenience tags that do not include browser version details (example: `cypress/browsers:22.11.0` and `cypress/included:13.16.0`). The tags that these images refer to can change without notice if browser updates are made.
106+
`cypress/browsers` and `cypress/included` images are also offered with short-form convenience tags that do not include browser version details (example: `cypress/browsers:22.19.0` and `cypress/included:15.1.0`). The tags that these images refer to can change without notice if browser updates are made.
107107

108108
Similarly, the convenience tag `latest`, for each of the image types, changes without notice.
109109

base/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313

1414
for example:
1515

16-
- `cypress/base:20.14.0`
16+
- `cypress/base:22.19.0`
1717
- `cypress/base:latest`
1818

1919
To avoid unplanned breaking changes, specify a fixed `<node version>` tag, not the `latest` tag.

browsers/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@
1919

2020
for example:
2121

22-
- `cypress/browsers:node-20.14.0-chrome-125.0.6422.141-1-ff-126.0.1-edge-125.0.2535.85-1`
23-
- `cypress/browsers:22.11.0`
22+
- `cypress/browsers:node-22.19.0-chrome-139.0.7258.154-1-ff-142.0.1-edge-139.0.3405.125-1`
23+
- `cypress/browsers:22.19.0`
2424
- `cypress/browsers:latest`
2525

2626
To avoid unplanned breaking changes, specify a fixed `<node version>` & `<browser version>` combination tag.

factory/README.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -63,15 +63,15 @@ They are not currently published to the npm registry and require the experimenta
6363

6464
The version of Cypress to install (via npm). If the `ARG` variable is unset or an empty string, Cypress is not installed.
6565

66-
Example: `CYPRESS_VERSION='13.11.0'`
66+
Example: `CYPRESS_VERSION='15.1.0'`
6767

6868
[Cypress versions](https://www.npmjs.com/package/cypress)
6969

7070
### CHROME_VERSION
7171

7272
The version of Google Chrome to install. If the `ARG` variable is unset or an empty string, Chrome is not installed. The exact version must be used, no wildcards or shorthands are supported.
7373

74-
Example: `CHROME_VERSION='131.0.6778.264-1'`
74+
Example: `CHROME_VERSION='139.0.7258.154-1'`
7575

7676
[Chrome versions](https://www.ubuntuupdates.org/package/google_chrome/stable/main/base/google-chrome-stable)
7777

@@ -81,7 +81,7 @@ This browser is currently available only for the `Linux/amd64` platform.
8181

8282
The version of [Google Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) to install. If the `ARG` variable is unset or an empty string, Chrome for Testing is not installed.
8383

84-
Example: `CHROME_FOR_TESTING_VERSION='137.0.7151.70'`
84+
Example: `CHROME_FOR_TESTING_VERSION='139.0.7258.154'`
8585

8686
Refer to [Chrome for Testing availability](https://googlechromelabs.github.io/chrome-for-testing/) for current versions or [available downloads](https://googlechromelabs.github.io/chrome-for-testing/files) for other versions.
8787

@@ -91,7 +91,7 @@ The parameter `CHROME_FOR_TESTING_VERSION` can be used for custom-built images b
9191

9292
The version of Mozilla Firefox to install. If the `ARG` variable is unset or an empty string, Firefox is not installed. The exact version must be used, no wildcards or shorthands are supported.
9393

94-
Example: `FIREFOX_VERSION='134.0'`
94+
Example: `FIREFOX_VERSION='142.0.1'`
9595

9696
[Firefox versions](https://download-installer.cdn.mozilla.net/pub/firefox/releases/)
9797

@@ -109,7 +109,7 @@ Example: `GECKODRIVER_VERSION='0.36.0'`
109109

110110
The version of Microsoft Edge to install. If the `ARG` variable is unset or an empty string, Edge is not installed. The exact version must be used, no wildcards or shorthands are supported.
111111

112-
Example: `EDGE_VERSION='131.0.2903.112-1'`
112+
Example: `EDGE_VERSION='139.0.3405.125-1'`
113113

114114
[Edge versions](https://packages.microsoft.com/repos/edge/pool/main/m/microsoft-edge-stable/)
115115

@@ -165,9 +165,9 @@ Create a `Dockerfile` with the following content:
165165
# Args are defined in the Dockerfile before the FROM command.
166166
# Using these args will cause an image to be created with
167167
# Node.js (default version from .env file), Chrome, Firefox and Edge.
168-
ARG CHROME_VERSION='131.0.6778.264-1'
169-
ARG EDGE_VERSION='131.0.2903.112-1'
170-
ARG FIREFOX_VERSION='134.0'
168+
ARG CHROME_VERSION='139.0.7258.154-1'
169+
ARG EDGE_VERSION='139.0.3405.125'
170+
ARG FIREFOX_VERSION='142.0.1'
171171

172172
FROM cypress/factory
173173

@@ -202,7 +202,7 @@ RUN npx cypress install
202202
Run the Docker commands:
203203

204204
```bash
205-
docker build . --build-arg CHROME_VERSION='131.0.6778.264-1' --build-arg EDGE_VERSION='131.0.2903.112-1' --build-arg FIREFOX_VERSION='134.0' -t test
205+
docker build . --build-arg CHROME_VERSION='139.0.7258.154-1' --build-arg EDGE_VERSION='139.0.3405.125-1' --build-arg FIREFOX_VERSION='142.0.1' -t test
206206
docker run -it --rm test npx cypress run -b chrome
207207
```
208208

@@ -218,9 +218,9 @@ services:
218218
build:
219219
context: .
220220
args:
221-
CHROME_VERSION: '125.0.6422.141-1'
222-
EDGE_VERSION: '125.0.2535.85-1'
223-
FIREFOX_VERSION: '126.0.1'
221+
CHROME_VERSION: '139.0.7258.154-1'
222+
EDGE_VERSION: '139.0.3405.125-1'
223+
FIREFOX_VERSION: '142.0.1'
224224
command: npx cypress run
225225
```
226226
@@ -251,7 +251,7 @@ Since this example only uses Chrome, removing Edge and Firefox is as simple as n
251251
Create a `Dockerfile` with the following content:
252252

253253
```dockerfile
254-
ARG CHROME_VERSION='131.0.6778.264-1'
254+
ARG CHROME_VERSION='139.0.7258.154-1'
255255
256256
FROM cypress/factory
257257
@@ -282,8 +282,6 @@ docker build . --build-arg HTTP_PROXY=http://my-corporate-proxy.com:3128 -t test
282282

283283
## Version Testing
284284

285-
Due to the large amount of possible version combinations, we're not able to exhaustively test each combination of versions, nor do we block versions that are incompatible. For example, Cypress 12 removed support for Node.js version 12.0.0. You are still able to generate a container with node 12.0.0 and Cypress 12, but Cypress will fail to run. This is because the factory supports earlier versions of Cypress and must support earlier versions of node.
285+
Due to the large amount of possible version combinations, we're not able to exhaustively test each combination of versions, nor do we block versions that are incompatible. For example, Cypress 12 removed support for Node.js version 12.0.0. You are still able to generate a container with Node.js 12.0.0 and Cypress 12, but Cypress will fail to run. This is because the factory supports earlier versions of Cypress and must support earlier versions of Node.js.
286286

287-
If you run across a combination that should reasonably work, but doesn't, log an issue and we will take a look at supporting it.
288-
289-
Additionally this docker image and containers generated from it are intended for test use only, and are not intended for hosting services in a production environment.
287+
Additionally, Cypress Docker images and containers generated from them are intended for test use only, and are not intended for hosting services in a production environment.

included/README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@
1919

2020
for example:
2121

22-
- `cypress/included:cypress-13.15.1-node-22.11.0-chrome-130.0.6723.69-1-ff-132.0-edge-130.0.2849.56-1`
23-
- `cypress/included:13.15.1`
22+
- `cypress/included:cypress-15.1.0-node-22.19.0-chrome-139.0.7258.154-1-ff-142.0.1-edge-139.0.3405.125-1`
23+
- `cypress/included:15.1.0`
2424
- `cypress/included:latest`
2525

2626
To avoid unplanned breaking changes, specify a fixed `<cypress version>`, `<node version>` & `<browser version>` combination tag.
@@ -111,49 +111,49 @@ docker run -it --rm --entrypoint cypress cypress/included info
111111
```
112112

113113
```text
114-
DevTools listening on ws://127.0.0.1:36243/devtools/browser/eb85524a-6459-41d6-b855-94c10cd2b242
114+
DevTools listening on ws://127.0.0.1:37627/devtools/browser/0db3d002-dc65-49b3-83a9-471ea4920af4
115115
Displaying Cypress info...
116116
117117
Detected 3 browsers installed:
118118
119119
1. Chrome
120120
- Name: chrome
121121
- Channel: stable
122-
- Version: 130.0.6723.69
122+
- Version: 139.0.7258.154
123123
- Executable: google-chrome
124124
125125
2. Edge
126126
- Name: edge
127127
- Channel: stable
128-
- Version: 130.0.2849.56
128+
- Version: 139.0.3405.125
129129
- Executable: edge
130130
131131
3. Firefox
132132
- Name: firefox
133133
- Channel: stable
134-
- Version: 132.0
134+
- Version: 142.0.1
135135
- Executable: firefox
136136
137137
Note: to run these browsers, pass <name>:<channel> to the '--browser' field
138138
139139
Examples:
140-
- cypress run --browser firefox
141140
- cypress run --browser chrome
141+
- cypress run --browser edge
142142
143143
Learn More: https://on.cypress.io/launching-browsers
144144
145145
Proxy Settings: none detected
146146
Environment Variables:
147147
CYPRESS_CACHE_FOLDER: /root/.cache/Cypress
148-
CYPRESS_FACTORY_DEFAULT_NODE_VERSION: 22.11.0
148+
CYPRESS_FACTORY_DEFAULT_NODE_VERSION: 22.19.0
149149
150150
Application Data: /root/.config/cypress/cy/development
151151
Browser Profiles: /root/.config/cypress/cy/development/browsers
152152
Binary Caches: /root/.cache/Cypress
153153
154-
Cypress Version: 13.15.1 (stable)
155-
System Platform: linux (Debian - 12.7)
156-
System Memory: 5.16 GB free 4.12 GB
154+
Cypress Version: 15.1.0 (stable)
155+
System Platform: linux (Debian - 13.0)
156+
System Memory: 5.16 GB free 3.79 GB
157157
```
158158

159159
## User

0 commit comments

Comments
 (0)