diff --git a/src/config/sidebar.ts b/src/config/sidebar.ts index 0cffebbd133..03537570f07 100644 --- a/src/config/sidebar.ts +++ b/src/config/sidebar.ts @@ -359,6 +359,10 @@ export const SIDEBAR: Partial> = { title: "Simulating Workflows", url: "cre/guides/operations/simulating-workflows", }, + { + title: "Testing Production Limits", + url: "cre/guides/operations/understanding-limits", + }, { title: "Deploying Workflows", url: "cre/guides/operations/deploying-workflows", diff --git a/src/content/cre/guides/operations/simulating-workflows.mdx b/src/content/cre/guides/operations/simulating-workflows.mdx index f3d5101c4e5..e24a47858a9 100644 --- a/src/content/cre/guides/operations/simulating-workflows.mdx +++ b/src/content/cre/guides/operations/simulating-workflows.mdx @@ -338,5 +338,6 @@ Despite these limitations, simulation is an essential tool for catching bugs, va ## Next steps +- **Test against production limits**: Use the `--limits` flag to enforce production quotas during simulation. See [Testing Production Limits](/cre/guides/operations/understanding-limits). - **Deploy your workflow**: Once you're confident your workflow works correctly, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). - **CLI reference**: For a complete list of flags and options, see the [CLI Workflow Commands reference](/cre/reference/cli/workflow/). diff --git a/src/content/cre/guides/operations/understanding-limits.mdx b/src/content/cre/guides/operations/understanding-limits.mdx new file mode 100644 index 00000000000..28a70fc03df --- /dev/null +++ b/src/content/cre/guides/operations/understanding-limits.mdx @@ -0,0 +1,127 @@ +--- +section: cre +date: Last Modified +title: "Testing Production Limits" +metadata: + description: "Test workflows against production limits locally: use the --limits flag to enforce, disable, or customize simulation limits before deploying." + datePublished: "2026-03-19" + lastModified: "2026-03-19" +--- + +import { Aside, CodeSample } from "@components" + +Simulation limits let you test your workflows against production constraints locally before deploying. By enforcing the same quotas that apply in production, you can catch violations early and avoid surprises at deploy time. + +## Why use simulation limits + +When you simulate a workflow, the CLI can enforce the same [service quotas](/cre/service-quotas) that your workflow will be subject to in production. This helps you: + +- **Catch violations early**: Identify workflows that exceed timeout, memory, or rate limits before deploying. +- **Match production behavior**: Ensure your local simulation mirrors how your workflow will run on the network. +- **Avoid surprises at deploy time**: Confidently deploy knowing your workflow operates within quota boundaries. + +## Using the `--limits` flag + +The `--limits` flag controls how simulation limits are enforced. It supports three modes: + +### Default limits (default behavior) + +By default, the simulator enforces embedded production limits. You do not need to pass any flag: + +```bash +cre workflow simulate my-workflow --target staging-settings +``` + +This is equivalent to explicitly passing `--limits default`: + +```bash +cre workflow simulate my-workflow --limits default --target staging-settings +``` + +### No limits + +To disable all limit enforcement during simulation, use `--limits none`: + +```bash +cre workflow simulate my-workflow --limits none --target staging-settings +``` + + + +### Custom limits + +You can provide a custom limits file to override specific values: + +```bash +cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings +``` + +See [Customizing limits](#customizing-limits) for how to create a custom limits file. + +## Viewing default limits + +Use the `cre workflow limits export` command to inspect the default production limits: + +```bash +cre workflow limits export +``` + +This outputs a JSON file containing all enforced limits and their default values. You can redirect the output to a file: + +```bash +cre workflow limits export > my-limits.json +``` + +## Customizing limits + +To customize limits for simulation: + +1. **Export the defaults** to a JSON file: + + ```bash + cre workflow limits export > my-limits.json + ``` + +2. **Edit the JSON file** to adjust the values you want to change. For example, you might increase the execution timeout or HTTP call limit for testing purposes. + +3. **Pass the custom file** to the simulator: + + ```bash + cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings + ``` + + + +## Default limit values + +The default limits enforced during simulation match the production quotas documented on the [Service Quotas](/cre/service-quotas) page. Use `cre workflow limits export` to inspect the exact values applied to your simulations. + +## Requesting limit increases + +If your workflow requires higher limits than the defaults, you can request a limit increase: + +1. Go to [cre.chain.link](https://cre.chain.link) and log in to your account. +2. Click **Help** in the sidebar. +3. Set **Issue Type** to **Other**. +4. In the **Description** field, include: + - Which limit you need increased + - The desired value + - The reason for the increase + + + +## Next steps + +- **Service quotas reference**: See the full [Service Quotas](/cre/service-quotas) page for all quota keys and values. +- **Simulating workflows**: Learn more about the simulation environment in [Simulating Workflows](/cre/guides/operations/simulating-workflows). +- **Deploy your workflow**: Once validated, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). diff --git a/src/content/cre/llms-full-go.txt b/src/content/cre/llms-full-go.txt index 04b66fb09a3..e556bb2115c 100644 --- a/src/content/cre/llms-full-go.txt +++ b/src/content/cre/llms-full-go.txt @@ -386,6 +386,12 @@ These quotas apply to each individual workflow. [Contact us](/cre/support-feedback) to discuss quota increases. + + --- # Support & Feedback @@ -5265,11 +5271,134 @@ Despite these limitations, simulation is an essential tool for catching bugs, va ## Next steps +- **Test against production limits**: Use the `--limits` flag to enforce production quotas during simulation. See [Testing Production Limits](/cre/guides/operations/understanding-limits). - **Deploy your workflow**: Once you're confident your workflow works correctly, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). - **CLI reference**: For a complete list of flags and options, see the [CLI Workflow Commands reference](/cre/reference/cli/workflow/). --- +# Testing Production Limits +Source: https://docs.chain.link/cre/guides/operations/understanding-limits +Last Updated: 2026-03-19 + +Simulation limits let you test your workflows against production constraints locally before deploying. By enforcing the same quotas that apply in production, you can catch violations early and avoid surprises at deploy time. + +## Why use simulation limits + +When you simulate a workflow, the CLI can enforce the same [service quotas](/cre/service-quotas) that your workflow will be subject to in production. This helps you: + +- **Catch violations early**: Identify workflows that exceed timeout, memory, or rate limits before deploying. +- **Match production behavior**: Ensure your local simulation mirrors how your workflow will run on the network. +- **Avoid surprises at deploy time**: Confidently deploy knowing your workflow operates within quota boundaries. + +## Using the `--limits` flag + +The `--limits` flag controls how simulation limits are enforced. It supports three modes: + +### Default limits (default behavior) + +By default, the simulator enforces embedded production limits. You do not need to pass any flag: + +```bash +cre workflow simulate my-workflow --target staging-settings +``` + +This is equivalent to explicitly passing `--limits default`: + +```bash +cre workflow simulate my-workflow --limits default --target staging-settings +``` + +### No limits + +To disable all limit enforcement during simulation, use `--limits none`: + +```bash +cre workflow simulate my-workflow --limits none --target staging-settings +``` + + + +### Custom limits + +You can provide a custom limits file to override specific values: + +```bash +cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings +``` + +See [Customizing limits](#customizing-limits) for how to create a custom limits file. + +## Viewing default limits + +Use the `cre workflow limits export` command to inspect the default production limits: + +```bash +cre workflow limits export +``` + +This outputs a JSON file containing all enforced limits and their default values. You can redirect the output to a file: + +```bash +cre workflow limits export > my-limits.json +``` + +## Customizing limits + +To customize limits for simulation: + +1. **Export the defaults** to a JSON file: + + ```bash + cre workflow limits export > my-limits.json + ``` + +2. **Edit the JSON file** to adjust the values you want to change. For example, you might increase the execution timeout or HTTP call limit for testing purposes. + +3. **Pass the custom file** to the simulator: + + ```bash + cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings + ``` + + + +## Default limit values + +The default limits enforced during simulation match the production quotas documented on the [Service Quotas](/cre/service-quotas) page. Use `cre workflow limits export` to inspect the exact values applied to your simulations. + +## Requesting limit increases + +If your workflow requires higher limits than the defaults, you can request a limit increase: + +1. Go to [cre.chain.link](https://cre.chain.link) and log in to your account. +2. Click **Help** in the sidebar. +3. Set **Issue Type** to **Other**. +4. In the **Description** field, include: + - Which limit you need increased + - The desired value + - The reason for the increase + + + +## Next steps + +- **Service quotas reference**: See the full [Service Quotas](/cre/service-quotas) page for all quota keys and values. +- **Simulating workflows**: Learn more about the simulation environment in [Simulating Workflows](/cre/guides/operations/simulating-workflows). +- **Deploy your workflow**: Once validated, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). + +--- + # Deploying Workflows Source: https://docs.chain.link/cre/guides/operations/deploying-workflows Last Updated: 2026-03-17 diff --git a/src/content/cre/llms-full-ts.txt b/src/content/cre/llms-full-ts.txt index 5c87be7d7f7..a6e320590d7 100644 --- a/src/content/cre/llms-full-ts.txt +++ b/src/content/cre/llms-full-ts.txt @@ -386,6 +386,12 @@ These quotas apply to each individual workflow. [Contact us](/cre/support-feedback) to discuss quota increases. + + --- # Support & Feedback @@ -4380,11 +4386,134 @@ Despite these limitations, simulation is an essential tool for catching bugs, va ## Next steps +- **Test against production limits**: Use the `--limits` flag to enforce production quotas during simulation. See [Testing Production Limits](/cre/guides/operations/understanding-limits). - **Deploy your workflow**: Once you're confident your workflow works correctly, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). - **CLI reference**: For a complete list of flags and options, see the [CLI Workflow Commands reference](/cre/reference/cli/workflow/). --- +# Testing Production Limits +Source: https://docs.chain.link/cre/guides/operations/understanding-limits +Last Updated: 2026-03-19 + +Simulation limits let you test your workflows against production constraints locally before deploying. By enforcing the same quotas that apply in production, you can catch violations early and avoid surprises at deploy time. + +## Why use simulation limits + +When you simulate a workflow, the CLI can enforce the same [service quotas](/cre/service-quotas) that your workflow will be subject to in production. This helps you: + +- **Catch violations early**: Identify workflows that exceed timeout, memory, or rate limits before deploying. +- **Match production behavior**: Ensure your local simulation mirrors how your workflow will run on the network. +- **Avoid surprises at deploy time**: Confidently deploy knowing your workflow operates within quota boundaries. + +## Using the `--limits` flag + +The `--limits` flag controls how simulation limits are enforced. It supports three modes: + +### Default limits (default behavior) + +By default, the simulator enforces embedded production limits. You do not need to pass any flag: + +```bash +cre workflow simulate my-workflow --target staging-settings +``` + +This is equivalent to explicitly passing `--limits default`: + +```bash +cre workflow simulate my-workflow --limits default --target staging-settings +``` + +### No limits + +To disable all limit enforcement during simulation, use `--limits none`: + +```bash +cre workflow simulate my-workflow --limits none --target staging-settings +``` + + + +### Custom limits + +You can provide a custom limits file to override specific values: + +```bash +cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings +``` + +See [Customizing limits](#customizing-limits) for how to create a custom limits file. + +## Viewing default limits + +Use the `cre workflow limits export` command to inspect the default production limits: + +```bash +cre workflow limits export +``` + +This outputs a JSON file containing all enforced limits and their default values. You can redirect the output to a file: + +```bash +cre workflow limits export > my-limits.json +``` + +## Customizing limits + +To customize limits for simulation: + +1. **Export the defaults** to a JSON file: + + ```bash + cre workflow limits export > my-limits.json + ``` + +2. **Edit the JSON file** to adjust the values you want to change. For example, you might increase the execution timeout or HTTP call limit for testing purposes. + +3. **Pass the custom file** to the simulator: + + ```bash + cre workflow simulate my-workflow --limits ./my-limits.json --target staging-settings + ``` + + + +## Default limit values + +The default limits enforced during simulation match the production quotas documented on the [Service Quotas](/cre/service-quotas) page. Use `cre workflow limits export` to inspect the exact values applied to your simulations. + +## Requesting limit increases + +If your workflow requires higher limits than the defaults, you can request a limit increase: + +1. Go to [cre.chain.link](https://cre.chain.link) and log in to your account. +2. Click **Help** in the sidebar. +3. Set **Issue Type** to **Other**. +4. In the **Description** field, include: + - Which limit you need increased + - The desired value + - The reason for the increase + + + +## Next steps + +- **Service quotas reference**: See the full [Service Quotas](/cre/service-quotas) page for all quota keys and values. +- **Simulating workflows**: Learn more about the simulation environment in [Simulating Workflows](/cre/guides/operations/simulating-workflows). +- **Deploy your workflow**: Once validated, see [Deploying Workflows](/cre/guides/operations/deploying-workflows). + +--- + # Deploying Workflows Source: https://docs.chain.link/cre/guides/operations/deploying-workflows Last Updated: 2026-03-17 diff --git a/src/content/cre/service-quotas.mdx b/src/content/cre/service-quotas.mdx index 630beb53a6e..efd50b3afae 100644 --- a/src/content/cre/service-quotas.mdx +++ b/src/content/cre/service-quotas.mdx @@ -144,3 +144,9 @@ These quotas apply to each individual workflow. ## Quota increases [Contact us](/cre/support-feedback) to discuss quota increases. + +