vercel rolling-release

The vercel rolling-release command (also available as vercel rr) is used to manage your project's rolling releases. Rolling releases allow you to gradually roll out new deployments to a small fraction of your users before promoting them to everyone.

vercel rolling-release [command]

Configure rolling release settings for a project.

vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval", "stages":[{"targetPercentage":10},{"targetPercentage":50},{"targetPercentage":100}]}'

Start a rolling release for a specific deployment.

vercel rolling-release start --dpl=dpl_abc

Options:

Examples:

vercel rr start --dpl=dpl_123abc456def
vercel rr start --dpl=https://my-project-abc123.vercel.app
vercel rr start --dpl=dpl_123 --yes

Approve the current stage of an active rolling release.

vercel rolling-release approve --dpl=dpl_abc --currentStageIndex=0

Abort an active rolling release.

vercel rolling-release abort --dpl=dpl_abc

Complete an active rolling release, promoting the deployment to 100% of traffic.

vercel rolling-release complete --dpl=dpl_abc

Fetch details about a rolling release.

vercel rolling-release fetch

These are options that only apply to the vercel rolling-release command.

The --cfg option is used to configure rolling release settings. It accepts a JSON string or the value 'disable' to turn off rolling releases.

vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"automatic", "stages":[{"targetPercentage":10,"duration":5},{"targetPercentage":100}]}'

The --dpl option specifies the deployment ID or URL for rolling release operations.

vercel rolling-release start --dpl=https://example.vercel.app

The --currentStageIndex option specifies the current stage index when approving a rolling release stage.

vercel rolling-release approve --currentStageIndex=0 --dpl=dpl_123

vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"automatic", "stages":[{"targetPercentage":10,"duration":5},{"targetPercentage":100}]}'

This configures a rolling release that starts at 10% traffic, automatically advances after 5 minutes, and then goes to 100%.

vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval","stages":[{"targetPercentage":10},{"targetPercentage":100}]}'

This configures a rolling release that starts at 10% traffic and requires manual approval to advance to 100%.

vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval", "stages":[{"targetPercentage":10},{"targetPercentage":50},{"targetPercentage":100}]}'

This configures a rolling release with three stages: 10%, 50%, and 100% traffic, each requiring manual approval.

vercel rolling-release configure --cfg='disable'

This disables rolling releases for the project.

The following global options can be passed when using the vercel rolling-release command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --scope
• --token

For more information on global options and their usage, refer to the options section.