Flow runs from deployments

[anticorrelator]

Adds a utility to create flow runs from a deployment and waits for a specified amount of time before returning the FlowRun object. Users can both override the default Deployment parameters as well as specify unlimited (or no) polling before returning from this function.

Closes #6850

Example

Checklist

• This pull request references any related issue by including "closes <link to issue>"
  • If no issue exists and your change is not a small fix, please create an issue first.
• This pull request includes tests or only affects documentation.
• This pull request includes a label categorizing the change e.g. fix, feature, enhancement

[netlify]

✅ Deploy Preview for prefect-orion ready!

Name	Link
🔨 Latest commit	f90fe51
🔍 Latest deploy log	https://app.netlify.com/sites/prefect-orion/deploys/633e4dd10a501b0009a928fb
😎 Deploy Preview	https://deploy-preview-7047--prefect-orion.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site settings.

[anna-geller]

QAed and it works well 🎉

One thing to consider is that currently, both run_deployment and schedule_deployment result in no auto-scheduled flag being set, some might expect that schedule_deployment leads to auto_scheduled=True. The current behavior seems correct to me since those don't run on a regular cadence (the schedule_deployment is technically a single ad-hoc run but just not executed immediately) but this is a matter of interpretation

[cicdw]

a few minor notes, this LGTM otherwise!

[anna-geller]

Works great!

for docs - code used for QA

from prefect.client.utilities import run_deployment

# run parametrized flow from deployment and wait for its completion before starting the next task
flow_run_obj = run_deployment(
    "parametrized/dev",
    parameters=dict(user="QA Run - waiting"),
)

# run parametrized flow from deployment and wait for its completion before starting the next task
run_deployment(
    "parametrized/dev",
    max_polls=-1,
    parameters=dict(user="QA Run - waiting forever until completion - no poll limits"),
)
# run parametrized flow from deployment and don't wait for completion
run_deployment(
    "parametrized/dev",
    max_polls=0,
    parameters=dict(user="QA Run - fire-and-forget 🔥"),
)

# run parametrized flow from deployment and don't wait for completion
not_finished_flow_run = run_deployment(
    "parametrized/dev",
    max_polls=2,
    poll_interval=2,
    parameters=dict(user="QA Run - very short polling"),
)
print(not_finished_flow_run.state)  # Pending

[abrookins]

Looks good to me!

[zanieb]

Exciting! Mostly asking for a change around timeout handling.

[zanieb]

Thanks for working through so many people's feedback!