Cloud Staging

Test in production before your users do

Your actor works locally but fails in the cloud. Different Docker images, network routing, proxy configs, and memory limits cause issues that only appear in Apify's production environment. Cloud Staging runs your actor in the real environment and validates everything before users see it.

What it checks

Docker build validation

Verifies your Dockerfile builds without errors on Apify's infrastructure. Catches missing dependencies, wrong base images, and build script failures.

Schema compliance

Fetches your actor's declared dataset schema and validates every output field against it. Same checks as Schema Validator, run in the cloud environment.

Structural consistency

Checks field presence across all items, type consistency per field, and empty array detection. Catches issues that only appear with real data.

Custom assertions

Set minimum result counts, required fields, and field type constraints — same assertion engine as Test Runner, applied in the cloud.

Run success validation

Verifies the actor completes with SUCCEEDED status. Catches crashes, timeouts, and out-of-memory errors that don't appear locally.

PASS/FAIL verdict

Clear overall result based on run status, schema validation, and all assertion checks. One answer: is this actor ready for production?

Example output

{
  "targetActor": "ryanclinton/website-contact-scraper",
  "runId": "abc123def456",
  "runStatus": "SUCCEEDED",
  "runDuration": 8.3,
  "results": 1,
  "schemaValidation": {
    "passed": true,
    "errors": 0,
    "warnings": 2,
    "details": [
      "Dataset schema found and validated against output",
      "Field 'socialLinks' only present in 1/1 items (100%)"
    ]
  },
  "assertions": {
    "passed": true,
    "checks": [
      { "check": "minResults >= 1", "passed": true, "actual": 1 },
      { "check": "field 'url' exists", "passed": true }
    ]
  },
  "overallResult": "PASS"
}

How it works

1

Connect your Apify token and enter the actor ID

2

The tool runs the actor on your account and analyzes the output

3

Get a detailed report with actionable fixes — results cached for free