Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
N
next.js
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Alex
next.js
Commits
e1d89834
Unverified
Commit
e1d89834
authored
Jul 16, 2026
by
Sebastian "Sebbie" Silbermann
Committed by
GitHub
Jul 16, 2026
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
[15.x][ci] Allow configuring the base URL for preview builds (#95830)
parent
a518d38b
Hide whitespace changes
Inline
Side-by-side
Showing
9 changed files
with
62 additions
and
12 deletions
+62
-12
action-info.js
.github/actions/next-stats-action/src/prepare/action-info.js
+3
-0
build_and_deploy.yml
.github/workflows/build_and_deploy.yml
+1
-1
build_and_test.yml
.github/workflows/build_and_test.yml
+6
-3
build_reusable.yml
.github/workflows/build_reusable.yml
+3
-0
pull_request_stats.yml
.github/workflows/pull_request_stats.yml
+2
-0
test_e2e_deploy_release.yml
.github/workflows/test_e2e_deploy_release.yml
+1
-1
create-preview-tarballs.js
scripts/create-preview-tarballs.js
+4
-2
test-new-tests.mjs
scripts/test-new-tests.mjs
+11
-5
next-deploy.ts
test/lib/next-modes/next-deploy.ts
+31
-0
No files found.
.github/actions/next-stats-action/src/prepare/action-info.js
View file @
e1d89834
...
@@ -15,6 +15,7 @@ module.exports = function actionInfo() {
...
@@ -15,6 +15,7 @@ module.exports = function actionInfo() {
GITHUB_REPOSITORY
,
GITHUB_REPOSITORY
,
GITHUB_EVENT_PATH
,
GITHUB_EVENT_PATH
,
PR_STATS_COMMENT_TOKEN
,
PR_STATS_COMMENT_TOKEN
,
PREVIEW_BUILDS_BASE_URL
,
}
=
process
.
env
}
=
process
.
env
delete
process
.
env
.
GITHUB_TOKEN
delete
process
.
env
.
GITHUB_TOKEN
...
@@ -59,6 +60,8 @@ module.exports = function actionInfo() {
...
@@ -59,6 +60,8 @@ module.exports = function actionInfo() {
isRelease
:
isRelease
:
GITHUB_REPOSITORY
===
'vercel/next.js'
&&
GITHUB_REPOSITORY
===
'vercel/next.js'
&&
(
GITHUB_REF
||
''
).
includes
(
'canary'
),
(
GITHUB_REF
||
''
).
includes
(
'canary'
),
previewBuildsBaseUrl
:
PREVIEW_BUILDS_BASE_URL
||
'https://vercel-packages.vercel.app/next'
,
}
}
if
(
info
.
isRelease
)
{
if
(
info
.
isRelease
)
{
...
...
.github/workflows/build_and_deploy.yml
View file @
e1d89834
...
@@ -570,7 +570,7 @@ jobs:
...
@@ -570,7 +570,7 @@ jobs:
-
name
:
Create tarballs
-
name
:
Create tarballs
# github.event.after is available on push and pull_request#synchronize events.
# github.event.after is available on push and pull_request#synchronize events.
# For workflow_dispatch events, github.sha is the head commit.
# For workflow_dispatch events, github.sha is the head commit.
run
:
node scripts/create-preview-tarballs.js "${{ github.sha }}" "${{ github.event.after || github.sha }}" "${{ runner.temp }}/preview-tarballs"
run
:
node scripts/create-preview-tarballs.js "${{ github.sha }}" "${{ github.event.after || github.sha }}" "${{ runner.temp }}/preview-tarballs"
"${{ vars.PREVIEW_BUILDS_BASE_URL }}"
-
name
:
Upload tarballs
-
name
:
Upload tarballs
uses
:
actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
# v7.0.1
uses
:
actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
# v7.0.1
...
...
.github/workflows/build_and_test.yml
View file @
e1d89834
...
@@ -560,7 +560,8 @@ jobs:
...
@@ -560,7 +560,8 @@ jobs:
node scripts/test-new-tests.mjs \
node scripts/test-new-tests.mjs \
--flake-detection \
--flake-detection \
--mode dev \
--mode dev \
--group ${{ matrix.group }}
--group ${{ matrix.group }} \
--preview-builds-base-url "${{ vars.PREVIEW_BUILDS_BASE_URL }}"
stepName
:
'
test-new-tests-dev-${{matrix.group}}'
stepName
:
'
test-new-tests-dev-${{matrix.group}}'
timeout_minutes
:
60
# Increase the default timeout as tests are intentionally run multiple times to detect flakes
timeout_minutes
:
60
# Increase the default timeout as tests are intentionally run multiple times to detect flakes
...
@@ -584,7 +585,8 @@ jobs:
...
@@ -584,7 +585,8 @@ jobs:
node scripts/test-new-tests.mjs \
node scripts/test-new-tests.mjs \
--flake-detection \
--flake-detection \
--mode start \
--mode start \
--group ${{ matrix.group }}
--group ${{ matrix.group }} \
--preview-builds-base-url "${{ vars.PREVIEW_BUILDS_BASE_URL }}"
stepName
:
'
test-new-tests-start-${{matrix.group}}'
stepName
:
'
test-new-tests-start-${{matrix.group}}'
timeout_minutes
:
60
# Increase the default timeout as tests are intentionally run multiple times to detect flakes
timeout_minutes
:
60
# Increase the default timeout as tests are intentionally run multiple times to detect flakes
secrets
:
inherit
secrets
:
inherit
...
@@ -608,7 +610,8 @@ jobs:
...
@@ -608,7 +610,8 @@ jobs:
export GH_PR_NUMBER=${{ github.event.pull_request && github.event.pull_request.number || '' }}
export GH_PR_NUMBER=${{ github.event.pull_request && github.event.pull_request.number || '' }}
node scripts/test-new-tests.mjs \
node scripts/test-new-tests.mjs \
--mode deploy \
--mode deploy \
--group ${{ matrix.group }}
--group ${{ matrix.group }} \
--preview-builds-base-url "${{ vars.PREVIEW_BUILDS_BASE_URL }}"
stepName
:
'
test-new-tests-deploy-${{matrix.group}}'
stepName
:
'
test-new-tests-deploy-${{matrix.group}}'
secrets
:
inherit
secrets
:
inherit
...
...
.github/workflows/build_reusable.yml
View file @
e1d89834
...
@@ -105,6 +105,9 @@ env:
...
@@ -105,6 +105,9 @@ env:
VERCEL_TEST_TEAM
:
vtest314-next-e2e-tests
VERCEL_TEST_TEAM
:
vtest314-next-e2e-tests
NEXT_TEST_PREFER_OFFLINE
:
1
NEXT_TEST_PREFER_OFFLINE
:
1
NEXT_CI_RUNNER
:
${{ inputs.runs_on_labels }}
NEXT_CI_RUNNER
:
${{ inputs.runs_on_labels }}
# Read token for the auth-protected preview-builds npm mirror, used by deploy
# tests to install Next.js artifacts during the remote build.
PREVIEW_BUILDS_READ_TOKEN
:
${{ secrets.PREVIEW_BUILDS_READ_TOKEN }}
jobs
:
jobs
:
build
:
build
:
...
...
.github/workflows/pull_request_stats.yml
View file @
e1d89834
...
@@ -59,3 +59,5 @@ jobs:
...
@@ -59,3 +59,5 @@ jobs:
-
uses
:
./.github/actions/next-stats-action
-
uses
:
./.github/actions/next-stats-action
if
:
${{ steps.docs-change.outputs.DOCS_CHANGE == 'nope' }}
if
:
${{ steps.docs-change.outputs.DOCS_CHANGE == 'nope' }}
env
:
PREVIEW_BUILDS_BASE_URL
:
${{ vars.PREVIEW_BUILDS_BASE_URL }}
.github/workflows/test_e2e_deploy_release.yml
View file @
e1d89834
...
@@ -81,7 +81,7 @@ jobs:
...
@@ -81,7 +81,7 @@ jobs:
matrix
:
matrix
:
group
:
[
1/6
,
2/6
,
3/6
,
4/6
,
5/6
,
6/6
]
group
:
[
1/6
,
2/6
,
3/6
,
4/6
,
5/6
,
6/6
]
with
:
with
:
afterBuild
:
npm i -g vercel@latest && NEXT_E2E_TEST_TIMEOUT=240000 NEXT_TEST_MODE=deploy NEXT_EXTERNAL_TESTS_FILTERS="test/deploy-tests-manifest.json" NEXT_TEST_VERSION="${{ github.event.inputs.nextVersion || 'canary' }}" VERCEL_CLI_VERSION="${{ github.event.inputs.vercelCliVersion || 'vercel@latest' }}" node run-tests.js --timings -g ${{ matrix.group }} -c 2 --type e2e
afterBuild
:
npm i -g vercel@latest && NEXT_E2E_TEST_TIMEOUT=240000 NEXT_TEST_MODE=deploy NEXT_EXTERNAL_TESTS_FILTERS="test/deploy-tests-manifest.json" NEXT_TEST_VERSION="${{ github.event.inputs.nextVersion || 'canary' }}" VERCEL_CLI_VERSION="${{ github.event.inputs.vercelCliVersion || 'vercel@latest' }}"
NEXT_TEST_PREVIEW_BUILDS_BASE_URL="${{ vars.PREVIEW_BUILDS_BASE_URL }}"
node run-tests.js --timings -g ${{ matrix.group }} -c 2 --type e2e
skipNativeBuild
:
'
yes'
skipNativeBuild
:
'
yes'
skipNativeInstall
:
'
no'
skipNativeInstall
:
'
no'
stepName
:
'
test-deploy-${{
matrix.group
}}'
stepName
:
'
test-deploy-${{
matrix.group
}}'
...
...
scripts/create-preview-tarballs.js
View file @
e1d89834
...
@@ -9,7 +9,9 @@ async function main() {
...
@@ -9,7 +9,9 @@ async function main() {
githubSha
,
githubSha
,
githubHeadSha
,
githubHeadSha
,
tarballDirectory
=
path
.
join
(
os
.
tmpdir
(),
'vercel-nextjs-preview-tarballs'
),
tarballDirectory
=
path
.
join
(
os
.
tmpdir
(),
'vercel-nextjs-preview-tarballs'
),
baseUrlArg
,
]
=
process
.
argv
.
slice
(
2
)
]
=
process
.
argv
.
slice
(
2
)
const
baseUrl
=
baseUrlArg
||
'https://vercel-packages.vercel.app/next'
const
repoRoot
=
path
.
resolve
(
__dirname
,
'..'
)
const
repoRoot
=
path
.
resolve
(
__dirname
,
'..'
)
await
fs
.
mkdir
(
tarballDirectory
,
{
recursive
:
true
})
await
fs
.
mkdir
(
tarballDirectory
,
{
recursive
:
true
})
...
@@ -103,13 +105,13 @@ async function main() {
...
@@ -103,13 +105,13 @@ async function main() {
for
(
const
packageInfo
of
packages
)
{
for
(
const
packageInfo
of
packages
)
{
packagesByVersion
.
set
(
packagesByVersion
.
set
(
packageInfo
.
name
,
packageInfo
.
name
,
`
https://vercel-packages.vercel.app/next
/commits/
${
githubHeadSha
}
/
${
packageInfo
.
name
}
`
`
${
baseUrl
}
/commits/
${
githubHeadSha
}
/
${
packageInfo
.
name
}
`
)
)
}
}
for
(
const
nextSwcPackageName
of
nextSwcPackageNames
)
{
for
(
const
nextSwcPackageName
of
nextSwcPackageNames
)
{
packagesByVersion
.
set
(
packagesByVersion
.
set
(
nextSwcPackageName
,
nextSwcPackageName
,
`
https://vercel-packages.vercel.app/next
/commits/
${
githubHeadSha
}
/
${
nextSwcPackageName
}
`
`
${
baseUrl
}
/commits/
${
githubHeadSha
}
/
${
nextSwcPackageName
}
`
)
)
}
}
...
...
scripts/test-new-tests.mjs
View file @
e1d89834
...
@@ -14,11 +14,14 @@ async function main() {
...
@@ -14,11 +14,14 @@ async function main() {
let
argv
=
await
yargs
(
process
.
argv
.
slice
(
2
))
let
argv
=
await
yargs
(
process
.
argv
.
slice
(
2
))
.
string
(
'mode'
)
.
string
(
'mode'
)
.
string
(
'group'
)
.
string
(
'group'
)
.
string
(
'preview-builds-base-url'
)
.
boolean
(
'flake-detection'
).
argv
.
boolean
(
'flake-detection'
).
argv
let
testMode
=
argv
.
mode
let
testMode
=
argv
.
mode
const
isFlakeDetectionMode
=
argv
[
'flake-detection'
]
const
isFlakeDetectionMode
=
argv
[
'flake-detection'
]
const
attempts
=
isFlakeDetectionMode
?
3
:
1
const
attempts
=
isFlakeDetectionMode
?
3
:
1
const
previewBuildsBaseUrl
=
argv
[
'preview-builds-base-url'
]
||
'https://vercel-packages.vercel.app/next'
if
(
testMode
&&
!
[
'dev'
,
'deploy'
,
'start'
].
includes
(
testMode
))
{
if
(
testMode
&&
!
[
'dev'
,
'deploy'
,
'start'
].
includes
(
testMode
))
{
throw
new
Error
(
throw
new
Error
(
...
@@ -79,24 +82,26 @@ async function main() {
...
@@ -79,24 +82,26 @@ async function main() {
}
}
const
RUN_TESTS_ARGS
=
[
'run-tests.js'
,
'-c'
,
'1'
,
'--retries'
,
'0'
]
const
RUN_TESTS_ARGS
=
[
'run-tests.js'
,
'-c'
,
'1'
,
'--retries'
,
'0'
]
const
PR_NUMBER
=
process
.
env
.
GH_PR_NUMBER
// Only override the test version for deploy tests, as they need to run against
// Only override the test version for deploy tests, as they need to run against
// the artifacts for the pull request. Otherwise, we don't need to specify this property,
// the artifacts for the pull request. Otherwise, we don't need to specify this property,
// as tests will run against the local version of Next.js
// as tests will run against the local version of Next.js
const
nextTestVersion
=
const
nextTestVersion
=
testMode
===
'deploy'
testMode
===
'deploy'
?
PR_NUMBER
?
`
${
previewBuildsBaseUrl
}
/commits/
${
commitSha
}
/next`
?
`https://vercel-packages.vercel.app/next/prs/
${
PR_NUMBER
}
/next`
:
`https://vercel-packages.vercel.app/next/commits/
${
commitSha
}
/next`
:
undefined
:
undefined
const
previewBuildsReadToken
=
process
.
env
.
PREVIEW_BUILDS_READ_TOKEN
if
(
nextTestVersion
)
{
if
(
nextTestVersion
)
{
console
.
log
(
`Verifying artifacts for commit
${
commitSha
}
`
)
console
.
log
(
`Verifying artifacts for commit
${
commitSha
}
`
)
// Attempt to fetch the deploy artifacts for the commit
// Attempt to fetch the deploy artifacts for the commit
// These might take a moment to become available, so we'll retry a few times
// These might take a moment to become available, so we'll retry a few times
const
fetchHeaders
=
previewBuildsReadToken
?
{
Authorization
:
`Bearer
${
previewBuildsReadToken
}
`
}
:
undefined
const
fetchWithRetry
=
async
(
url
,
retries
=
5
,
timeout
=
5000
)
=>
{
const
fetchWithRetry
=
async
(
url
,
retries
=
5
,
timeout
=
5000
)
=>
{
for
(
let
i
=
0
;
i
<
retries
;
i
++
)
{
for
(
let
i
=
0
;
i
<
retries
;
i
++
)
{
const
res
=
await
fetch
(
url
)
const
res
=
await
fetch
(
url
,
{
headers
:
fetchHeaders
}
)
if
(
res
.
ok
)
{
if
(
res
.
ok
)
{
return
res
return
res
}
else
if
(
i
<
retries
-
1
)
{
}
else
if
(
i
<
retries
-
1
)
{
...
@@ -152,6 +157,7 @@ async function main() {
...
@@ -152,6 +157,7 @@ async function main() {
env
:
{
env
:
{
...
process
.
env
,
...
process
.
env
,
NEXT_TEST_MODE
:
testMode
,
NEXT_TEST_MODE
:
testMode
,
NEXT_TEST_PREVIEW_BUILDS_BASE_URL
:
previewBuildsBaseUrl
,
NEXT_TEST_VERSION
:
nextTestVersion
,
NEXT_TEST_VERSION
:
nextTestVersion
,
IS_TURBOPACK_TEST
:
'1'
,
IS_TURBOPACK_TEST
:
'1'
,
TURBOPACK_BUILD
:
testMode
===
'start'
?
'1'
:
undefined
,
TURBOPACK_BUILD
:
testMode
===
'start'
?
'1'
:
undefined
,
...
...
test/lib/next-modes/next-deploy.ts
View file @
e1d89834
...
@@ -25,6 +25,7 @@ export class NextDeployInstance extends NextInstance {
...
@@ -25,6 +25,7 @@ export class NextDeployInstance extends NextInstance {
super
.
setup
(
parentSpan
)
super
.
setup
(
parentSpan
)
await
super
.
createTestDir
({
parentSpan
,
skipInstall
:
true
})
await
super
.
createTestDir
({
parentSpan
,
skipInstall
:
true
})
await
this
.
writeMirrorNpmrcIfNecessary
()
// ensure Vercel CLI is installed
// ensure Vercel CLI is installed
try
{
try
{
const
res
=
await
execa
(
'vercel'
,
[
'--version'
])
const
res
=
await
execa
(
'vercel'
,
[
'--version'
])
...
@@ -168,6 +169,36 @@ export class NextDeployInstance extends NextInstance {
...
@@ -168,6 +169,36 @@ export class NextDeployInstance extends NextInstance {
this
.
_cliOutput
=
buildLogs
.
stdout
+
buildLogs
.
stderr
this
.
_cliOutput
=
buildLogs
.
stdout
+
buildLogs
.
stderr
}
}
// When the preview-builds npm mirror is auth-protected, the deploy build
// installs Next.js artifacts from it and needs credentials. We write an
// `.npmrc` with a read token (provided as a CI secret) so the remote install
// can authenticate. Only written when the token is set, so unprotected and
// local deploy runs are unaffected.
private
async
writeMirrorNpmrcIfNecessary
():
Promise
<
void
>
{
const
token
=
process
.
env
.
PREVIEW_BUILDS_READ_TOKEN
const
baseUrlRaw
=
process
.
env
.
NEXT_TEST_PREVIEW_BUILDS_BASE_URL
if
(
!
token
||
!
baseUrlRaw
)
{
require
(
'console'
).
log
(
`Skipping .npmrc write for preview-builds mirror: missing token or base URL`
)
return
}
const
baseUrl
=
new
URL
(
baseUrlRaw
)
// Derive the npmrc auth key from the mirror base URL: strip the scheme and
// ensure a trailing slash so it matches requests to that registry path.
const
registryKey
=
`//
${
baseUrl
.
host
}${
baseUrl
.
pathname
.
replace
(
/
\/?
$/
,
'/'
)}
`
require
(
'console'
).
log
(
`Writing .npmrc for preview-builds mirror:
${
registryKey
}
`
)
await
fs
.
writeFile
(
path
.
join
(
this
.
testDir
,
'.npmrc'
),
`
${
registryKey
}
:_authToken=
${
token
}
\n`
)
}
public
get
cliOutput
()
{
public
get
cliOutput
()
{
return
this
.
_cliOutput
||
''
return
this
.
_cliOutput
||
''
}
}
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment