Deployment Windows

Deployment windows restrict when deployments can execute in a stage. Use them to prevent production deployments outside of business hours when your team is available to respond to issues.

Pacific Time Only

Deployment windows are currently available in Pacific Time only. Custom time windows, additional timezones, and holiday-aware scheduling are planned for a future release. "Weekdays only" means Monday through Friday regardless of public holidays.

Available Windows

Window	Hours	Days
NONE	No restriction -- deployments run anytime.	All days
PACIFIC_WORKING_HOURS	9:00 AM -- 5:00 PM Pacific Time	Weekdays only (Mon--Fri)
PACIFIC_WORKING_HOURS_REDUCED	10:00 AM -- 4:00 PM Pacific Time	Weekdays only (Mon--Fri)

Custom deployment windows are not currently supported — only the three presets above are available.

Configuration

Set deployment windows per stage or as a default for all stages:

pipeline:
  stage_defaults:
    deployment_time_window: PACIFIC_WORKING_HOURS

  stages:
    - name: staging
      deployment_time_window: NONE          # Override: deploy anytime
      account_id: "111111111111"
      region: us-east-1

    - name: production
      # Inherits PACIFIC_WORKING_HOURS from defaults
      account_id: "222222222222"
      region: us-east-1

Behavior

When a deployment reaches a stage that's outside its deployment window:

1. The deployment queues and waits for the window to open.
2. When the window opens, the deployment resumes automatically.
3. If a newer deployment has been queued in the meantime, only the latest one deploys (intermediate pushes are skipped).

Deployment windows don't affect:

• Pipeline synthesis (always runs immediately).
• Artifact builds (always run immediately).
• Stages with deployment_time_window: NONE.

Common Patterns

Unrestricted staging, restricted production

stages:
  - name: staging
    deployment_time_window: NONE
    # ...
  - name: production
    deployment_time_window: PACIFIC_WORKING_HOURS
    # ...

Tighter window for critical stages

stages:
  - name: staging
    deployment_time_window: NONE
    # ...
  - name: prod-us-east-1
    deployment_time_window: PACIFIC_WORKING_HOURS
    # ...
  - name: prod-eu-west-2
    deployment_time_window: PACIFIC_WORKING_HOURS_REDUCED
    # ...

Emergency Override

If you need to deploy outside a deployment window (e.g., during an incident), use Bypass Deployment Blockers in the dashboard. This allows a single deployment to proceed regardless of the time window.