Is it possible to use

.with_options()

on a flow deployment, without using a sub-flow to capture the

.with_options()

values? i.e. the following

.with_options()

works locally, but not after I deploy it (running the deployment completely ignores the

.with_options()

parameters):

@flow
def my_test_flow():
    print('hello')

if __name__ == 'main':
    my_test_flow.with_options(name='some other name')()

The following uses a subflow to capture the options before running the flow. It works, but do I HAVE to do it this way?

@flow
def my_test_flow():
    print('hello')

@flow
def main_flow():
    my_test_flow().with_options(name='some other name')()

if __name__ == 'main':
    main_flow()

I'd typically use the

@flow

decorator instead, but I need to use

.with_options

so that I can utilize some parameter over-loads from my

--param

arguments for

prefect deployment build

directly on the flow

hi @Zachary Loertscher - this comes down to the difference between a

Flow

and a

Deployment

with_options

is a class method on a

Flow

, which means it takes the existing instance of a flow and returns a modified version of it (with your setting overrides) - this flow instance knows nothing about any

Deployment

that may refer to it (as intended) if you're running a pre-defined deployment, you'll want to use `run_deployment`(docs) and provide any overrides like

parameters

or

flow_run_name

as kwargs there

Thanks for this great information! is

run_deployment

something you would use like this?

@flow
def my_test_flow():
    print('hello')

if __name__ == "main":
    run_deployment()

where I was previously doing...

@flow
def my_test_flow():
    print('hello')

if __name__ == "main":
    my_test_flow()

Just trying to understand how it fits in - it seems like it would replace calling a specific flow

it seems like it would replace calling a specific flow

in a sense - yes!

run_deployment

will trigger a flow run from a deployed flow. so whatever you see when you do

prefect deployment ls

can be triggered with

run_deployment

. here's a (somewhat involved) example using

run_deployment

Interesting - I will have to dig deeper into this option!! Looks like I would still be using a sub-flow if I want to run my deployment from prefect cloud. I'd have to call

run_deployment

from a separate process, right?

by

if I want to run my deployment from prefect cloud

do you mean basically clicking "Custom Run" in the UI on a deployment but only programmatically? if so, yes you'd have to call

run_deployment

from somewhere

Yep - just because we have our CRON's set up in prefect cloud so that's what would be calling the deployment, which calls the flow, etc.

ah if you have a cron schedule attached to your deployment already that youd like to use to trigger your deployment, then you wouldnt need to call it otherwise run_deployment is for the case where you want to programmatically trigger an adhoc run of a deployment (with custom params if you so choose)

This all makes sense - thank you so much for answering my questions! I'll continue down the route I currently have, then 🙂

cool - no problem!