2.14.17 Release Notes (PrefectHQ#11731)

Co-authored-by: nate nowack <thrast36@gmail.com>
Co-authored-by: Serina Grill <42048900+serinamarie@users.noreply.github.com>

RELEASE-NOTES.md

@@ -1,5 +1,113 @@
 # Prefect Release Notes
 
+## Release 2.14.17
+
+### **Experimental**: Non-blocking submission of flow runs to the `Runner` web server
+You can now submit runs of served flows without blocking the main thread, from inside or outside a flow run. If submitting flows from inside a parent flow, these submitted runs will be tracked as subflows of the parent flow run.
+
+<img width="1159" alt="Prefect flow run graph screenshot" src="https://github.com/PrefectHQ/prefect/assets/31014960/9c2787bb-fb00-49d9-8611-80ad7584bda0">
+
+In order to use this feature, you must:
+- enable the experimental `Runner` webserver endpoints via
+    ```console
+    prefect config set PREFECT_EXPERIMENTAL_ENABLE_EXTRA_RUNNER_ENDPOINTS=True
+    ```
+- ensure the `Runner` web server is enabled, either by:
+    - passing `webserver=True` to your `serve` call
+    - enabling the webserver via
+    ```console
+    prefect config set PREFECT_RUNNER_SERVER_ENABLE=True
+    ```
+    
+You can then submit any flow available in the import space of the served flow, and you can submit multiple runs at once. If submitting flows from a parent flow, you may optionally block the parent flow run from completing until all submitted runs are complete with `wait_for_submitted_runs()`.
+
+<details>
+    <summary>Click for an example</summary>
+
+```python
+import time
+
+from pydantic import BaseModel
+
+from prefect import flow, serve, task
+from prefect.runner import submit_to_runner, wait_for_submitted_runs
+
+
+class Foo(BaseModel):
+    bar: str
+    baz: int
+
+
+class ParentFoo(BaseModel):
+    foo: Foo
+    x: int = 42
+
+@task
+def noop():
+    pass
+
+@flow(log_prints=True)
+async def child(foo: Foo = Foo(bar="hello", baz=42)):
+    print(f"received {foo.bar} and {foo.baz}")
+    print("going to sleep")
+    noop()
+    time.sleep(20)
+
+
+@task
+def foo():
+    time.sleep(2)
+
+@flow(log_prints=True)
+def parent(parent_foo: ParentFoo = ParentFoo(foo=Foo(bar="hello", baz=42))):
+    print(f"I'm a parent and I received {parent_foo=}")
+
+    submit_to_runner(
+        child, [{"foo": Foo(bar="hello", baz=i)} for i in range(9)]
+    )
+    
+    foo.submit()
+    
+    wait_for_submitted_runs() # optionally block until all submitted runs are complete
+    
+
+if __name__ == "__main__":
+    # either enable the webserver via `webserver=True` or via
+    # `prefect config set PREFECT_RUNNER_SERVER_ENABLE=True`
+    serve(parent.to_deployment(__file__), limit=10, webserver=True)
+```
+
+</details>
+
+This feature is experimental and subject to change. Please try it out and let us know what you think!
+
+See [the PR](https://github.com/PrefectHQ/prefect/pull/11476) for implementation details.
+
+### Enhancements
+- Add `url` to `prefect.runtime.flow_run` — https://github.com/PrefectHQ/prefect/pull/11686
+- Add ability to subpath the `/ui-settings` endpoint — https://github.com/PrefectHQ/prefect/pull/11701
+
+### Fixes
+- Handle `pydantic` v2 types in schema generation for flow parameters — https://github.com/PrefectHQ/prefect/pull/11656
+- Increase flow run resiliency by gracefully handling `PENDING` to `PENDING` state transitions — https://github.com/PrefectHQ/prefect/pull/11695
+
+### Documentation
+- Add documentation for `cache_result_in_memory` argument for `flow` decorator — https://github.com/PrefectHQ/prefect/pull/11669
+- Add runnable example of `flow.from_source()` — https://github.com/PrefectHQ/prefect/pull/11690
+- Improve discoverability of creating interactive workflows guide — https://github.com/PrefectHQ/prefect/pull/11704
+- Fix typo in automations guide — https://github.com/PrefectHQ/prefect/pull/11716
+- Remove events and incidents from concepts index page — https://github.com/PrefectHQ/prefect/pull/11708
+- Remove subflow task tag concurrency warning — https://github.com/PrefectHQ/prefect/pull/11725
+- Remove misleading line on pausing a flow run from the UI — https://github.com/PrefectHQ/prefect/pull/11730
+- Improve readability of Jinja templating guide in automations concept doc — https://github.com/PrefectHQ/prefect/pull/11729
+- Resolve links to relocated interactive workflows guide — https://github.com/PrefectHQ/prefect/pull/11692
+- Fix typo in flows concept documentation — https://github.com/PrefectHQ/prefect/pull/11693
+
+### Contributors
+- @sgbaird
+
+**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.16...2.14.17
+
 ## Release 2.14.16
 
 ### Support for access block fields in `prefect.yaml` templating