From 3c7c21a3d5c2177672ccaad9ad02b4a29946f50f Mon Sep 17 00:00:00 2001
From: Jenny G <40272060+zhen0@users.noreply.github.com>
Date: Tue, 28 Nov 2023 11:18:17 -0500
Subject: [PATCH] Release notes for 2.14.7 (#11262)
Co-authored-by: Jeff Hale
Co-authored-by: Serina Grill <42048900+serinamarie@users.noreply.github.com>
Co-authored-by: Jeff Hale
Co-authored-by: urimandujano
---
RELEASE-NOTES.md | 3609 ++++++++++++++++++++++++++--------------------
1 file changed, 2068 insertions(+), 1541 deletions(-)
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 756b3b75067b..dd20ed6e7833 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,5 +1,30 @@
# Prefect Release Notes
+## Release 2.14.7
+
+This release fixes a bug introduced in 2.14.6 where deployments with default Docker image builds looked for images tagged `v2.14.6` instead of `2.14.6`. Users of `2.14.6` should upgrade if planning to create deployments with an image other than a custom image.
+
+### Enhancements
+
+- Use a new route to read work pool types when connected to Prefect Cloud —
+- Add `parent_flow_run_id` as a new API filter for flow runs —
+
+### Fixes
+
+- Allow more than one dependency package in the requirements of a push or pull step —
+
+### Documentation
+
+- Add serverless work pool landing page —
+- Update Azure Container Instance guide to reflect current Azure Portal interface and Prefect UI —
+- Update imports in **Flows** concept page example —
+
+### New Contributors
+
+- @oakbramble made their first contribution in
+
+**All changes**:
+
## Release 2.14.6
### View the next run for a deployment at a glance
@@ -11,7 +36,7 @@ Click below to see it in action!
](https://github.com/PrefectHQ/prefect/assets/12350579/c1658f50-512a-4cd4-9d36-a523d3cc9ef0)
See the following pull request for implementation details:
-— https://github.com/PrefectHQ/prefect/pull/11230
+—
### Automatic project configuration for Cloud Run push work pools
@@ -61,25 +86,29 @@ If you have yet to try using a Cloud Run run push pool, now is a great time!
If you use another cloud provider, don't fret; we will add support for ECS and Azure Container Instances push work pools in future releases!
See the following pull request for implementation details:
-— https://github.com/PrefectHQ/prefect/pull/11204
+—
### Enhancements
-- Add ability to search for block documents by name in the Prefect UI and API — https://github.com/PrefectHQ/prefect/pull/11212
-- Add pagination to the Blocks page in the Prefect UI for viewing/filtering more than 200 blocks — https://github.com/PrefectHQ/prefect/pull/11214
-- Include concurrency controls in `prefect-client` — https://github.com/PrefectHQ/prefect/pull/11227
+
+- Add ability to search for block documents by name in the Prefect UI and API —
+- Add pagination to the Blocks page in the Prefect UI for viewing/filtering more than 200 blocks —
+- Include concurrency controls in `prefect-client` —
### Fixes
-- Fix SQLite migration to work with older SQLite versions — https://github.com/PrefectHQ/prefect/pull/11215
-- Fix Subflow Runs tab filters and persist to URL in the Flow Runs page of the Prefect UI — https://github.com/PrefectHQ/prefect/pull/11218
+
+- Fix SQLite migration to work with older SQLite versions —
+- Fix Subflow Runs tab filters and persist to URL in the Flow Runs page of the Prefect UI —
### Documentation
-- Improve formatting in deployment guides — https://github.com/PrefectHQ/prefect/pull/11217
-- Add instructions for turning off the flow run logger to the unit testing guide — https://github.com/PrefectHQ/prefect/pull/11223
+
+- Improve formatting in deployment guides —
+- Add instructions for turning off the flow run logger to the unit testing guide —
### Contributors
+
- @ConstantinoSchillebeeckx
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.5...2.14.6
+**All changes**:
## Release 2.14.5
@@ -122,42 +151,47 @@ if __name__ == "__main__":
Note that a storage block must be saved before deploying a flow, but not if you're serving a remotely stored flow.
See the following pull request for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/11092
+
+-
### Enhancements
-- Add customizable host and port settings for worker webserver — https://github.com/PrefectHQ/prefect/pull/11175
-- Safely retrieve `flow_run_id` in `EventsWorker` while finding related events — https://github.com/PrefectHQ/prefect/pull/11182
-- Add client-side setting for specifying a default work pool — https://github.com/PrefectHQ/prefect/pull/11137
-- Allow configuration of task run tag concurrency slot delay transition time via setting — https://github.com/PrefectHQ/prefect/pull/11020
-- Enable enhanced flow run cancellation by default - https://github.com/PrefectHQ/prefect/pull/11192
+
+- Add customizable host and port settings for worker webserver —
+- Safely retrieve `flow_run_id` in `EventsWorker` while finding related events —
+- Add client-side setting for specifying a default work pool —
+- Allow configuration of task run tag concurrency slot delay transition time via setting —
+- Enable enhanced flow run cancellation by default -
### Fixes
-- Fix access token retrieval when using `GitRepository` with a private repo and `.deploy` — https://github.com/PrefectHQ/prefect/pull/11156
-- Fix bug where check for required packages fails incorrectly during `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/11111
-- Fix routing to the Flows page from a flow run in the Prefect UI — https://github.com/PrefectHQ/prefect/pull/11190
-- Ensure the Prefect UI Flow Runs page reacts to filter changes - https://github.com/PrefectHQ/prefect-ui-library/pull/1874
-- Optimize memory usage by clearing `args/kwargs` in a Prefect `Call` post-execution - https://github.com/PrefectHQ/prefect/pull/11153
-- Allow logs to handle un-`uuid`-like flow_run_ids - https://github.com/PrefectHQ/prefect/pull/11191
-- Only run unit tests for Python file changes — https://github.com/PrefectHQ/prefect/pull/11159
-- Add `codespell` config and add to pre-commit — https://github.com/PrefectHQ/prefect/pull/10893
-- Update token regex in release notes generation script for VSCode compatibility - https://github.com/PrefectHQ/prefect/pull/11195
+
+- Fix access token retrieval when using `GitRepository` with a private repo and `.deploy` —
+- Fix bug where check for required packages fails incorrectly during `prefect deploy` —
+- Fix routing to the Flows page from a flow run in the Prefect UI —
+- Ensure the Prefect UI Flow Runs page reacts to filter changes -
+- Optimize memory usage by clearing `args/kwargs` in a Prefect `Call` post-execution -
+- Allow logs to handle un-`uuid`-like flow_run_ids -
+- Only run unit tests for Python file changes —
+- Add `codespell` config and add to pre-commit —
+- Update token regex in release notes generation script for VSCode compatibility -
### Documentation
-- Add Terraform Provider guide, update and simplify guides navigation — https://github.com/PrefectHQ/prefect/pull/11170
-- Clarify and harmonize Prefect Cloud documentation to reflect nomenclature and UX changes — https://github.com/PrefectHQ/prefect/pull/11157
-- Add information on Prefect Cloud to README — https://github.com/PrefectHQ/prefect/pull/11167
-- Update work pool-based deployment guide to include `.deploy` — https://github.com/PrefectHQ/prefect/pull/11174
-- Add Github information to auth-related Prefect Cloud documentation — https://github.com/PrefectHQ/prefect/pull/11178
-- Update workers tutorial — https://github.com/PrefectHQ/prefect/pull/11185
-- Update mkdocs material pin — https://github.com/PrefectHQ/prefect/pull/11160
-- Fix typo in audit log documentation — https://github.com/PrefectHQ/prefect/pull/11161
-- Fix typo in workers tutorial example — https://github.com/PrefectHQ/prefect/pull/11183
+
+- Add Terraform Provider guide, update and simplify guides navigation —
+- Clarify and harmonize Prefect Cloud documentation to reflect nomenclature and UX changes —
+- Add information on Prefect Cloud to README —
+- Update work pool-based deployment guide to include `.deploy` —
+- Add Github information to auth-related Prefect Cloud documentation —
+- Update workers tutorial —
+- Update mkdocs material pin —
+- Fix typo in audit log documentation —
+- Fix typo in workers tutorial example —
### Contributors
-- @yarikoptic made their first contribution in https://github.com/PrefectHQ/prefect/pull/10893
+
+- @yarikoptic made their first contribution in
- @taljaards
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.4...2.14.5
+**All changes**:
## Release 2.14.4
@@ -170,38 +204,43 @@ The flow run graph in the Prefect UI has been rebuilt from the ground up, offeri
See the following pull requests for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/11112
-- https://github.com/PrefectHQ/prefect/pull/11105
-- https://github.com/PrefectHQ/prefect/pull/11113
-- https://github.com/PrefectHQ/prefect/pull/11132
-- https://github.com/PrefectHQ/prefect/pull/11138
+
+-
+-
+-
+-
+-
### Enhancements
-- Add API route for block counts — https://github.com/PrefectHQ/prefect/pull/11090
+
+- Add API route for block counts —
- Improved tag handling on `DeploymentImage` for `.deploy`:
- - https://github.com/PrefectHQ/prefect/pull/11115
- - https://github.com/PrefectHQ/prefect/pull/11119
-- Allow `image` passed into `.deploy` to be optional if loading flow from storage — https://github.com/PrefectHQ/prefect/pull/11117
-- Ensure client avoids image builds when deploying to managed work pools — https://github.com/PrefectHQ/prefect/pull/11120
-- Add `SIGTERM` handling to runner to gracefully handle timeouts — https://github.com/PrefectHQ/prefect/pull/11133
-- Allow tasks to use `get_run_logger` w/o parent flow run — https://github.com/PrefectHQ/prefect/pull/11129
-- Allow `ResultFactory` creation `from_task` when no `flow_run_context` — https://github.com/PrefectHQ/prefect/pull/11134
+ -
+ -
+- Allow `image` passed into `.deploy` to be optional if loading flow from storage —
+- Ensure client avoids image builds when deploying to managed work pools —
+- Add `SIGTERM` handling to runner to gracefully handle timeouts —
+- Allow tasks to use `get_run_logger` w/o parent flow run —
+- Allow `ResultFactory` creation `from_task` when no `flow_run_context` —
### Fixes
-- Avoid printing references to workers when deploying to managed pools — https://github.com/PrefectHQ/prefect/pull/11122
+
+- Avoid printing references to workers when deploying to managed pools —
### Documentation
-- Fix docstring for `flow.deploy` method example — https://github.com/PrefectHQ/prefect/pull/11108
-- Add warning about image architecture to push pool guide — https://github.com/PrefectHQ/prefect/pull/11118
-- Move webhooks guide to `Development` section in guides index — https://github.com/PrefectHQ/prefect/pull/11141
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.3...2.14.4
+- Fix docstring for `flow.deploy` method example —
+- Add warning about image architecture to push pool guide —
+- Move webhooks guide to `Development` section in guides index —
+
+**All changes**:
## Release 2.14.3
### Observability with deployment status
You can now track the status of your deployments in the Prefect UI, which is especially useful when serving flows as they have no associated work pool or worker. If you see a flow run enter a `LATE` state (it isn’t running), you can click into the deployment for that flow run and see a red indicator next to your deployment. The worker, runner, or agent polling that deployment or its associated work queue is offline.
+
- Deployments created from served flows will have a `READY` status if its associated process is running.
- Deployments created in a work pool will have a `READY` status when a worker is `ONLINE` and polling the associated work queue.
- Deployments created in a push work pool (Prefect Cloud) will always have a `READY` status.
@@ -222,10 +261,11 @@ You can also create an automation triggered by deployment status changes on the
See the following pull requests for implementation details:
-- https://github.com/PrefectHQ/prefect-ui-library/pull/1801
-- https://github.com/PrefectHQ/prefect/pull/10969
-- https://github.com/PrefectHQ/prefect/pull/10951
-- https://github.com/PrefectHQ/prefect/pull/10949
+
+-
+-
+-
+-
### Additional storage options for `flow.from_source`
@@ -259,39 +299,44 @@ if __name__ == "__main__":
```
See the following pull request for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/11072
+
+-
### Enhancements
-- Add option to skip building a Docker image with `flow.deploy` — https://github.com/PrefectHQ/prefect/pull/11082
-- Display placeholder on the variables page when no variables are present — https://github.com/PrefectHQ/prefect/pull/11044
-- Allow composite sort of block documents by `block_type_name` and name — https://github.com/PrefectHQ/prefect/pull/11054
-- Add option to configure a warning via `PREFECT_TASK_INTROSPECTION_WARN_THRESHOLD` if task parameter introspection takes a long time — https://github.com/PrefectHQ/prefect/pull/11075
+
+- Add option to skip building a Docker image with `flow.deploy` —
+- Display placeholder on the variables page when no variables are present —
+- Allow composite sort of block documents by `block_type_name` and name —
+- Add option to configure a warning via `PREFECT_TASK_INTROSPECTION_WARN_THRESHOLD` if task parameter introspection takes a long time —
### Fixes
-- Update cancellation cleanup service to allow for infrastructure teardown — https://github.com/PrefectHQ/prefect/pull/11055
-- Allow `password` to be provided in `credentials` for `GitRespository` — https://github.com/PrefectHQ/prefect/pull/11056
-- Enable page refresh loading for non dashboard pages — https://github.com/PrefectHQ/prefect/pull/11065
-- Allow runner to load remotely stored flows when running hooks — https://github.com/PrefectHQ/prefect/pull/11077
-- Fix reading of flow run graph with unstarted runs — https://github.com/PrefectHQ/prefect/pull/11070
-- Allow Pydantic V2 models in flow function signatures — https://github.com/PrefectHQ/prefect/pull/10966
-- Run `prefect-client` build workflow on reqs.txt updates — https://github.com/PrefectHQ/prefect/pull/11079
-- Skips unsupported Windows tests — https://github.com/PrefectHQ/prefect/pull/11076
-- Avoid yanked `pytest-asyncio==0.22.0` — https://github.com/PrefectHQ/prefect/pull/11064
+
+- Update cancellation cleanup service to allow for infrastructure teardown —
+- Allow `password` to be provided in `credentials` for `GitRespository` —
+- Enable page refresh loading for non dashboard pages —
+- Allow runner to load remotely stored flows when running hooks —
+- Fix reading of flow run graph with unstarted runs —
+- Allow Pydantic V2 models in flow function signatures —
+- Run `prefect-client` build workflow on reqs.txt updates —
+- Skips unsupported Windows tests —
+- Avoid yanked `pytest-asyncio==0.22.0` —
### Documentation
-- Add guide to daemonize a worker or `.serve` process with systemd — https://github.com/PrefectHQ/prefect/pull/11008
-- Add clarification of term `task` in Global Concurrency docs — https://github.com/PrefectHQ/prefect/pull/11085
-- Update Global Concurrency guide to highlight general purpose use of concurrency limits — https://github.com/PrefectHQ/prefect/pull/11074
-- Update push work pools documentation to mention concurrency — https://github.com/PrefectHQ/prefect/pull/11068
-- Add documentation on Prefect Cloud teams — https://github.com/PrefectHQ/prefect/pull/11057
-- Update 2.14.2 release notes — https://github.com/PrefectHQ/prefect/pull/11053
-- Fix rendering of marketing banner on the Prefect dashboard — https://github.com/PrefectHQ/prefect/pull/11069
-- Fix typo in `README.md` — https://github.com/PrefectHQ/prefect/pull/11058
+
+- Add guide to daemonize a worker or `.serve` process with systemd —
+- Add clarification of term `task` in Global Concurrency docs —
+- Update Global Concurrency guide to highlight general purpose use of concurrency limits —
+- Update push work pools documentation to mention concurrency —
+- Add documentation on Prefect Cloud teams —
+- Update 2.14.2 release notes —
+- Fix rendering of marketing banner on the Prefect dashboard —
+- Fix typo in `README.md` —
## New Contributors
-* @vatsalya-vyas made their first contribution in https://github.com/PrefectHQ/prefect/pull/11058
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.2...2.14.3
+- @vatsalya-vyas made their first contribution in
+
+**All changes**:
## Release 2.14.2
@@ -320,22 +365,26 @@ assert data == {"my_arg": "custom_value", "state": state}
This can be used in conjunction with the `.with_options` method on tasks and flows to dynamically provide extra kwargs to your hooks, like [this example](https://docs.prefect.io/latest/concepts/states/#pass-kwargs-to-your-hooks) in the docs.
See the following pull request for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/11022
+
+-
### Fixes
-- Moves responsibility for running `on_cancellation` and `on_crashed` flow hooks to runner when present — https://github.com/PrefectHQ/prefect/pull/11026
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.1...2.14.2
+- Moves responsibility for running `on_cancellation` and `on_crashed` flow hooks to runner when present —
+
+**All changes**:
## Release 2.14.1
### Documentation
-- Add Python `serve` and `deploy` options to the `schedules` concepts documentation — https://github.com/PrefectHQ/prefect/pull/11000
+
+- Add Python `serve` and `deploy` options to the `schedules` concepts documentation —
### Fixes
-- Refine flow parameter validation to use the correct form of validation depending on if the parameter is a pydantic v1 or v2 model. — https://github.com/PrefectHQ/prefect/pull/11028
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.14.0...2.14.1
+- Refine flow parameter validation to use the correct form of validation depending on if the parameter is a pydantic v1 or v2 model. —
+
+**All changes**:
## Release 2.14.0
@@ -360,26 +409,32 @@ hello_world()
```
See implementation details in the following pull request:
-- https://github.com/PrefectHQ/prefect/pull/10988
+
+-
### Enhancements
-- Add flow name to the label for subflow runs in the Prefect UI — https://github.com/PrefectHQ/prefect/pull/11009
+
+- Add flow name to the label for subflow runs in the Prefect UI —
### Fixes
-- Fix ability to pull flows and build deployments in Windows environments - https://github.com/PrefectHQ/prefect/pull/10989
-- Remove unnecessary work queue health indicator from push pools in the Prefect UI dashboard - https://github.com/PrefectHQ/prefect-ui-library/pull/1813
-- Rename mismatched alembic file — https://github.com/PrefectHQ/prefect/pull/10888
+
+- Fix ability to pull flows and build deployments in Windows environments -
+- Remove unnecessary work queue health indicator from push pools in the Prefect UI dashboard -
+- Rename mismatched alembic file —
### Documentation
-- Standardize heading capitalization in guide to developing a new worker type — https://github.com/PrefectHQ/prefect/pull/10999
-- Update Docker guide to mention image builds with `prefect.yaml` and `flow.deploy` — https://github.com/PrefectHQ/prefect/pull/11012
-- Update Kubernetes guide to mention and link to Python-based flow `deploy` creation method — https://github.com/PrefectHQ/prefect/pull/11010
+
+- Standardize heading capitalization in guide to developing a new worker type —
+- Update Docker guide to mention image builds with `prefect.yaml` and `flow.deploy` —
+- Update Kubernetes guide to mention and link to Python-based flow `deploy` creation method —
## New Contributors
-* @m-steinhauer made their first contribution in https://github.com/PrefectHQ/prefect/pull/10888
-* @maitlandmarshall made their first contribution in https://github.com/PrefectHQ/prefect/pull/10989
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.8...2.14.0
+- @m-steinhauer made their first contribution in
+
+- @maitlandmarshall made their first contribution in
+
+**All changes**:
## Release 2.13.8
@@ -441,38 +496,43 @@ if __name__ == "__main__":
You can also use `deploy` as a replacement for `serve` if you want to deploy multiple flows at once.
-For more information, check out our tutorial's newly updated [Worker & Work Pools](https://docs.prefect.io/latest/tutorial/workers/) section!
+For more information, check out our tutorial's newly updated [Worker & Work Pools](https://docs.prefect.io/latest/tutorial/workers/) section!
See implementation details in the following pull requests:
-- https://github.com/PrefectHQ/prefect/pull/10957
-- https://github.com/PrefectHQ/prefect/pull/10975
-- https://github.com/PrefectHQ/prefect/pull/10993
+
+-
+-
+-
### Enhancements
-- Add `last_polled` column to deployment table — https://github.com/PrefectHQ/prefect/pull/10949
-- Add `status` and `last_polled` to deployment API responses — https://github.com/PrefectHQ/prefect/pull/10951
-- Add flow run graph v2 endpoint tuned for UI applications — https://github.com/PrefectHQ/prefect/pull/10912
-- Add ability to convert `GitRepository` into `git_clone` deployment step — https://github.com/PrefectHQ/prefect/pull/10957
-- Update `/deployments/get_scheduled_flow_runs` endpoint to update deployment status — https://github.com/PrefectHQ/prefect/pull/10969
+
+- Add `last_polled` column to deployment table —
+- Add `status` and `last_polled` to deployment API responses —
+- Add flow run graph v2 endpoint tuned for UI applications —
+- Add ability to convert `GitRepository` into `git_clone` deployment step —
+- Update `/deployments/get_scheduled_flow_runs` endpoint to update deployment status —
### Fixes
-- Clarify CLI prompt message for missing integration library for worker — https://github.com/PrefectHQ/prefect/pull/10990
-- Renamed `ruamel-yaml` to `ruamel.yaml` in `requirements.txt` — https://github.com/PrefectHQ/prefect/pull/10987
-- Clarify work pool banner on Work Pool page UI — https://github.com/PrefectHQ/prefect/pull/10992
+
+- Clarify CLI prompt message for missing integration library for worker —
+- Renamed `ruamel-yaml` to `ruamel.yaml` in `requirements.txt` —
+- Clarify work pool banner on Work Pool page UI —
### Documentation
-- Clean up `Using the Prefect Orchestration Client` guide — https://github.com/PrefectHQ/prefect/pull/10968
-- Add link to Coiled's documentation for hosting served flows — https://github.com/PrefectHQ/prefect/pull/10977
-- Clarify that access control lists do not affect related objects — https://github.com/PrefectHQ/prefect/pull/10934
-- Improve block-based deployment concept page metadata and admonitions — https://github.com/PrefectHQ/prefect/pull/10970
-- Update docs to prioritize workers over agents — https://github.com/PrefectHQ/prefect/pull/10904
-- Update work pools and workers tutorial to use `flow.deploy` — https://github.com/PrefectHQ/prefect/pull/10985
-- Move Docker image discussion to Docker guide — https://github.com/PrefectHQ/prefect/pull/10910
+
+- Clean up `Using the Prefect Orchestration Client` guide —
+- Add link to Coiled's documentation for hosting served flows —
+- Clarify that access control lists do not affect related objects —
+- Improve block-based deployment concept page metadata and admonitions —
+- Update docs to prioritize workers over agents —
+- Update work pools and workers tutorial to use `flow.deploy` —
+- Move Docker image discussion to Docker guide —
### Contributors
-* @lpequignot made their first contribution in https://github.com/PrefectHQ/prefect/pull/10987
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.7...2.13.8
+- @lpequignot made their first contribution in
+
+**All changes**:
## Release 2.13.7
@@ -481,16 +541,18 @@ See implementation details in the following pull requests:
In 2.13.5 we released experimental support for Pydantic V2, which made it co-installable via forced install. In this release, we are enabling co-installation by default which will allow you to leverage Pydantic V2 in your flows and tasks. Additionally, you can choose to update to Pydantic V2 on your own timeline as we maintain compatibility with V1 within flows and tasks.
See implementation details in the following pull request:
-- https://github.com/PrefectHQ/prefect/pull/10946
+
+-
### Documentation
-- Fix typo in release notes - https://github.com/PrefectHQ/prefect/pull/10950
+- Fix typo in release notes -
### Contributors
+
- @taljaards
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.6...2.13.7
+**All changes**:
## Release 2.13.6
@@ -510,14 +572,16 @@ deployments:
env:
PREFECT_DEFAULT_RESULT_STORAGE_BLOCK: s3/my-s3-bucket-block-name
```
+
This enhancement enables easier swapping of result storages by just updating the environment in the UI or in your `prefect.yaml`, eliminating the need to alter your flow source code.
See the following pull request for details:
-- https://github.com/PrefectHQ/prefect/pull/10925
+
+-
### Experimental support for enhanced cancellation
-We're introducing a new experimental feature that will enable more consistent and reliable cancellation of flow runs.
+We're introducing a new experimental feature that will enable more consistent and reliable cancellation of flow runs.
To enable enhanced cancellation, set the `PREFECT_EXPERIMENTAL_ENABLE_ENHANCED_CANCELLATION` setting on your worker or agents to `True`:
@@ -530,34 +594,40 @@ When enabled, you can cancel flow runs where cancellation can fail, such as when
Note: If you are using the Kubernetes worker, you will need to update your `prefect-kubernetes` installation to `0.3.1`. If you are using the Cloud Run or Vertex AI workers, you will need to update your `prefect-gcp` installation to `0.5.1`.
See the following pull requests for details:
-- https://github.com/PrefectHQ/prefect/pull/10920
-- https://github.com/PrefectHQ/prefect/pull/10944
+
+-
+-
### Enhancements
-- Add link to Prefect Cloud information in the Prefect UI — https://github.com/PrefectHQ/prefect/pull/10909
+
+- Add link to Prefect Cloud information in the Prefect UI —
### Fixes
-- Avoid `prefect deploy` prompt for remote storage if a global pull step is already defined - https://github.com/PrefectHQ/prefect/pull/10941
+
+- Avoid `prefect deploy` prompt for remote storage if a global pull step is already defined -
### Documentation
-- Add a guide for using the Prefect client — https://github.com/PrefectHQ/prefect/pull/10924
-- Remove icons from side navigation for improved readability — https://github.com/PrefectHQ/prefect/pull/10908
-- Update deployments tutorial for consistent styling — https://github.com/PrefectHQ/prefect/pull/10911
-- Fix typo in CLI command in deployments tutorial — https://github.com/PrefectHQ/prefect/pull/10937
-- Fix typo in logging guide — https://github.com/PrefectHQ/prefect/pull/10936
-- Update documentation styling — https://github.com/PrefectHQ/prefect/pull/10913
+
+- Add a guide for using the Prefect client —
+- Remove icons from side navigation for improved readability —
+- Update deployments tutorial for consistent styling —
+- Fix typo in CLI command in deployments tutorial —
+- Fix typo in logging guide —
+- Update documentation styling —
### Contributors
-* @Sun-of-a-beach made their first contribution in https://github.com/PrefectHQ/prefect/pull/10937
+
+- @Sun-of-a-beach made their first contribution in
+
- @manaw
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.5...2.13.6
+**All changes**:
## Release 2.13.5
### Load and serve remotely stored flows
-You can now load and serve flows from a git repository!
+You can now load and serve flows from a git repository!
With the new `flow.from_source` method, you can specify a git repository and a path to a flow file in that repository. This method will return a flow object that can be run or served with `flow.serve()`.
@@ -578,119 +648,140 @@ When you load and serve a flow from a git repository, the serving process will p
To learn more about loading and serving flows from a git repository, check out [the docs](https://docs.prefect.io/latest/concepts/flows/#retrieve-a-flow-from-remote-storage)!
See the following pull requests for details:
-- https://github.com/PrefectHQ/prefect/pull/10884
-- https://github.com/PrefectHQ/prefect/pull/10850
+
+-
+-
### Experimental Pydantic 2 Compatibility
We're working eagerly toward having `prefect` installable with either `pydantic<2` or `pydantic>2`. As a first step toward compatibility, we've ensured that Prefect's use of `pydantic` is isolated from _your_ use of `pydantic` in as many ways as possible. As of this release, `prefect` still has a stated `pydantic` requirement of `<2`, but we are testing against `pydantic>2` in our continuous integration tests. If you're feeling adventurous, feel free to manually install `pydantic>2` and run some flows with it. If you do, please let us know how it's going with a note in Slack or with a Github issue.
See the following pull requests for details
-- https://github.com/PrefectHQ/prefect/pull/10860
-- https://github.com/PrefectHQ/prefect/pull/10867
-- https://github.com/PrefectHQ/prefect/pull/10868
-- https://github.com/PrefectHQ/prefect/pull/10870
-- https://github.com/PrefectHQ/prefect/pull/10873
-- https://github.com/PrefectHQ/prefect/pull/10891
-- https://github.com/PrefectHQ/prefect/pull/10876
+
+-
+-
+-
+-
+-
+-
+-
### Enhancements
-- Use flow run context for default values in task run logger — https://github.com/PrefectHQ/prefect/pull/10334
-- Default `PREFECT_UI_API_URL` to relative path /api — https://github.com/PrefectHQ/prefect/pull/10755
-- Add blob storage options to `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10656
-- Add retries on responses with a 408 status code — https://github.com/PrefectHQ/prefect/pull/10883
+
+- Use flow run context for default values in task run logger —
+- Default `PREFECT_UI_API_URL` to relative path /api —
+- Add blob storage options to `prefect deploy` —
+- Add retries on responses with a 408 status code —
### Fixes
-- Ensure agents only query work queues in `default-agent-pool` work pool if no pool is specified — https://github.com/PrefectHQ/prefect/pull/10804
-- Update `Runner` to correctly handle spaces in Python executable path — https://github.com/PrefectHQ/prefect/pull/10878
-- Update `PREFECT__FLOW_RUN_ID` environment variable to dash-delimited UUID format — https://github.com/PrefectHQ/prefect/pull/10881
-- Fix bug preventing importing `prefect` in a thread — https://github.com/PrefectHQ/prefect/pull/10871
+
+- Ensure agents only query work queues in `default-agent-pool` work pool if no pool is specified —
+- Update `Runner` to correctly handle spaces in Python executable path —
+- Update `PREFECT__FLOW_RUN_ID` environment variable to dash-delimited UUID format —
+- Fix bug preventing importing `prefect` in a thread —
### Documentation
-- Add GCP Vertex AI worker to worker types list in work pools documentation — https://github.com/PrefectHQ/prefect/pull/10858
-- Expound upon rate limit info and global concurrency use cases in concurrency guide — https://github.com/PrefectHQ/prefect/pull/10886
-- Point docker guide link to tutorial on workers — https://github.com/PrefectHQ/prefect/pull/10872
-- Clarify workers and work pools as an alternative to `.serve()` in tutorials — https://github.com/PrefectHQ/prefect/pull/10861
-- Fix typo in deployments concept page — https://github.com/PrefectHQ/prefect/pull/10857
-- Remove beta label from push work pool documentation — https://github.com/PrefectHQ/prefect/pull/10848
+
+- Add GCP Vertex AI worker to worker types list in work pools documentation —
+- Expound upon rate limit info and global concurrency use cases in concurrency guide —
+- Point docker guide link to tutorial on workers —
+- Clarify workers and work pools as an alternative to `.serve()` in tutorials —
+- Fix typo in deployments concept page —
+- Remove beta label from push work pool documentation —
### Contributors
-* @alexmojaki made their first contribution in https://github.com/PrefectHQ/prefect/pull/10334
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.4...2.13.5
+- @alexmojaki made their first contribution in
+
+**All changes**:
## Release 2.13.4
### Enhancements
-- Lift API and database constraints that require task runs to have an associated flow run id — https://github.com/PrefectHQ/prefect/pull/10816
+
+- Lift API and database constraints that require task runs to have an associated flow run id —
### Fixes
-- Fix an issue with infinite scrolling on the sub flow runs tab in the UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1788
+
+- Fix an issue with infinite scrolling on the sub flow runs tab in the UI -
### Documentation
-- Add dark mode base job template screenshot to work pools documentation — https://github.com/PrefectHQ/prefect/pull/10849
-- Drop beta tag from push work pools documentation — https://github.com/PrefectHQ/prefect/pull/10799
-- Improve logo sizing and general housekeeping - https://github.com/PrefectHQ/prefect/pull/10830
+
+- Add dark mode base job template screenshot to work pools documentation —
+- Drop beta tag from push work pools documentation —
+- Improve logo sizing and general housekeeping -
## Release 2.13.3
## Allow configuration of a work pool's base job template via the CLI
+
Previously, the creation and modification of work pools, including editing the base job template, were done through the Prefect UI. Now you can alter the base job template through CLI commands:
Retrieve the default base job template for a given work pool:
+
```bash
prefect work-pool get-default-base-job-template --type kubernetes
```
You can customize the base job template by passing a JSON file to the `--base-job-template` flag:
+
```bash
prefect work-pool create my-k8s-pool --type kubernetes --base-job-template ./path/template.yaml
```
Useful for version control, you can now make updates to a work pool's base job template via the CLI:
+
```bash
prefect work-pool update my-work-pool --base-job-template base-job-template.json --description "My work pool" --concurrency-limit 10
```
See the documentation on [work pools](https://docs.prefect.io/latest/concepts/work-pools/) for more information, or see the following pull requests for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/10793
-- https://github.com/PrefectHQ/prefect/pull/10797
-- https://github.com/PrefectHQ/prefect/pull/10796
-- https://github.com/PrefectHQ/prefect/pull/10798
-- https://github.com/PrefectHQ/prefect/pull/10844
+
+-
+-
+-
+-
+-
## Allow users to customize their default flow runs view in the Prefect UI
-You can now set your own default filter view on your Flow Runs page! You must first save and name a view before you can set it as your default. This setting is only stored locally so it will not be shared across machines/browsers.
+
+You can now set your own default filter view on your Flow Runs page! You must first save and name a view before you can set it as your default. This setting is only stored locally so it will not be shared across machines/browsers.
Note: The previous default view ("Default view") has been renamed to "Past week".
## New Google Vertex AI work pool and worker
-- Run flows in containers on Google Vertex AI.
+
+- Run flows in containers on Google Vertex AI.
- Requires a Google Cloud Platform account and prefect-gcp library installed. Read more [here](https://prefecthq.github.io/prefect-gcp/vertex_worker/).
### Enhancements
-- Display `pull_steps` on Deployments page in the Prefect UI — https://github.com/PrefectHQ/prefect/pull/10819
-- Add `/deployments/get_scheduled_flow_runs` endpoint for retrieving scheduled flow runs from deployments — https://github.com/PrefectHQ/prefect/pull/10817
-- Add flow run filter for fetching the first-level subflows for a given flow — https://github.com/PrefectHQ/prefect/pull/10806
+
+- Display `pull_steps` on Deployments page in the Prefect UI —
+- Add `/deployments/get_scheduled_flow_runs` endpoint for retrieving scheduled flow runs from deployments —
+- Add flow run filter for fetching the first-level subflows for a given flow —
### Fixes
-- Raise `RuntimeError` error if `pip_install_requirements` step fails — https://github.com/PrefectHQ/prefect/pull/10823
-- Use a fixed list of known collection registry views - https://github.com/PrefectHQ/prefect/pull/10838
+
+- Raise `RuntimeError` error if `pip_install_requirements` step fails —
+- Use a fixed list of known collection registry views -
### Documentation
-- Fix typos in documentation and codebase — https://github.com/PrefectHQ/prefect/pull/10813
-- Fix example in tasks concept documentation — https://github.com/PrefectHQ/prefect/pull/10833
-- Update `git_clone` deployment step example in documentation — https://github.com/PrefectHQ/prefect/pull/10827
-- Add `prefect deploy` guide to guide index for visibility — https://github.com/PrefectHQ/prefect/pull/10828
-- Fix warning in deployment storage guide documentation — https://github.com/PrefectHQ/prefect/pull/10825
+
+- Fix typos in documentation and codebase —
+- Fix example in tasks concept documentation —
+- Update `git_clone` deployment step example in documentation —
+- Add `prefect deploy` guide to guide index for visibility —
+- Fix warning in deployment storage guide documentation —
### Contributors
-* @arthurgtllr made their first contribution in https://github.com/PrefectHQ/prefect/pull/10833
+
+- @arthurgtllr made their first contribution in
+
- @mj0nez
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.2...2.13.3
+**All changes**:
## Release 2.13.2
@@ -724,6 +815,7 @@ if __name__ == "__main__":
```
An attempt to run the created deployment with invalid parameters will fail and give a reason the flow run cannot be created:
+
```bash
> prefect deployment run 'my-flow/testing-params' -p person='{"name": 1}'
@@ -733,124 +825,143 @@ Error creating flow run: Validation failed for field 'person.name'. Failure reas
You can enable parameter enforcement via `prefect deploy` with the `--enforce-parameter-schema` flag or by setting `enforce_parameter_schema` to `True` in your `prefect.yaml` file.
See the following pull request for details:
-- https://github.com/PrefectHQ/prefect/pull/10773
+
+-
### Enhanced deployment flexibility with pattern-based deploying
In an effort to increase flexibility and provide more powerful deployment options, this enhancement enables users to deploy flows based on a variety of patterns, facilitating versatile and dynamic deployment management:
**Deploy all deployments for a specific flow:**
+
```bash
prefect deploy -n flow-a/*
```
**Deploy all deployments for a specific deployment:**
+
```bash
prefect deploy -n */prod
```
+
Note: This was previously possible in non-interactive mode with `prefect --no-prompt deploy -n prod`
**Deploy all deployments containing a specified string in the flow name:**
+
```bash
prefect deploy -n *extract*/*
```
**Deploy deployments with a mix of pattern matching styles**
+
```bash
prefect deploy -n flow-a/* -n */prod
```
**Deploy deployments with a mix of pattern matching and without:**
+
```bash
prefect deploy -n flow-a/* -n flow-b/default
```
See the following pull request for details:
-- https://github.com/PrefectHQ/prefect/pull/10772
+
+-
### Enhancements
-- Add API route for work pool counts — https://github.com/PrefectHQ/prefect/pull/10770
-- Add CLI command to get default base job template — https://github.com/PrefectHQ/prefect/pull/10776
+
+- Add API route for work pool counts —
+- Add CLI command to get default base job template —
### Fixes
-- Make paths relative rather than absolute in the `prefect dev build-ui` command — https://github.com/PrefectHQ/prefect/pull/10390
-- Lower the upper bound on pinned pendulum library — https://github.com/PrefectHQ/prefect/pull/10752
-- Fix command handling in `run_shell_script` deployment step on Windows — https://github.com/PrefectHQ/prefect/pull/10719
-- Fix validation on concurrency limits — https://github.com/PrefectHQ/prefect/pull/10790
-- Fix Prefect variable resolution in deployments section of `prefect.yaml` — https://github.com/PrefectHQ/prefect/pull/10783
+
+- Make paths relative rather than absolute in the `prefect dev build-ui` command —
+- Lower the upper bound on pinned pendulum library —
+- Fix command handling in `run_shell_script` deployment step on Windows —
+- Fix validation on concurrency limits —
+- Fix Prefect variable resolution in deployments section of `prefect.yaml` —
### Documentation
-- Update UI screenshot for role creation — https://github.com/PrefectHQ/prefect/pull/10732
-- Add `push work pools` tag to push work pools guide to raise visibility — https://github.com/PrefectHQ/prefect/pull/10739
-- Update docs with recent brand changes — https://github.com/PrefectHQ/prefect/pull/10736
-- Update Prefect Cloud quickstart guide to include new features — https://github.com/PrefectHQ/prefect/pull/10742
-- Fix broken diagram in workers tutorial — https://github.com/PrefectHQ/prefect/pull/10762
-- Add screenshots to artifacts concept page — https://github.com/PrefectHQ/prefect/pull/10748
-- Remove boost from block-based deployments page in documentation and improve visibility of `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10775
-- Add example of retrieving default base job template to work pools concept documentation — https://github.com/PrefectHQ/prefect/pull/10784
-- Add references to `enforce_parameter_schema` to docs — https://github.com/PrefectHQ/prefect/pull/10782
-- Add documentation for pattern matching in `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10791
+
+- Update UI screenshot for role creation —
+- Add `push work pools` tag to push work pools guide to raise visibility —
+- Update docs with recent brand changes —
+- Update Prefect Cloud quickstart guide to include new features —
+- Fix broken diagram in workers tutorial —
+- Add screenshots to artifacts concept page —
+- Remove boost from block-based deployments page in documentation and improve visibility of `prefect deploy` —
+- Add example of retrieving default base job template to work pools concept documentation —
+- Add references to `enforce_parameter_schema` to docs —
+- Add documentation for pattern matching in `prefect deploy` —
### New contributors
-* @danielhstahl made their first contribution in https://github.com/PrefectHQ/prefect/pull/10390
-* @morremeyer made their first contribution in https://github.com/PrefectHQ/prefect/pull/10759
-* @NikoRaisanen made their first contribution in https://github.com/PrefectHQ/prefect/pull/10719
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.1...2.13.2
+- @danielhstahl made their first contribution in
+
+- @morremeyer made their first contribution in
+- @NikoRaisanen made their first contribution in
+
+**All changes**:
## Release 2.13.1
### Hide subflow runs in the Prefect UI
+
We’ve added the ability to filter out subflow runs from the list on the Flow Runs page! This feature is especially beneficial for those who frequently use subflows, making it easier to focus on parent flows with less clutter.
![Hide subflows in UI demo](https://github.com/PrefectHQ/prefect/assets/31014960/7f6a9473-8003-4a90-8ff7-4d766623b38b)
See the following for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/10708
+
+-
### Enhancements
-- Add `run_count` to `prefect.runtime.flow_run` — https://github.com/PrefectHQ/prefect/pull/10676
-- Add `run_count` to `prefect.runtime.task_run` — https://github.com/PrefectHQ/prefect/pull/10676
-- Allow passing deployment triggers via CLI with `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10690
-- Add `is_null` filter for deployments to `/flows/filter` endpoint — https://github.com/PrefectHQ/prefect/pull/10724
-- Show associated flow name on Custom Run page in the Prefect UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1744
-- Add ability to reset a task-based concurrency limit from the UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1746
-- Display error `details` returned by API - https://github.com/PrefectHQ/prefect-ui-library/pull/1712
-- Add pagination to Deployments and Flows pages in the Prefect UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1732
-- Add opt-in to display large flow run graphs in Prefect UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1739
-- Add Prefect logo to UI sidebar and fix dashboard padding — https://github.com/PrefectHQ/prefect/pull/10684
-- Add ability to update existing deployment configurations with `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10718
+
+- Add `run_count` to `prefect.runtime.flow_run` —
+- Add `run_count` to `prefect.runtime.task_run` —
+- Allow passing deployment triggers via CLI with `prefect deploy` —
+- Add `is_null` filter for deployments to `/flows/filter` endpoint —
+- Show associated flow name on Custom Run page in the Prefect UI -
+- Add ability to reset a task-based concurrency limit from the UI -
+- Display error `details` returned by API -
+- Add pagination to Deployments and Flows pages in the Prefect UI -
+- Add opt-in to display large flow run graphs in Prefect UI -
+- Add Prefect logo to UI sidebar and fix dashboard padding —
+- Add ability to update existing deployment configurations with `prefect deploy` —
### Fixes
-- Avoid creating unpersisted blocks remotely — https://github.com/PrefectHQ/prefect/pull/10649
-- Handling DST in `CronSchedules` — https://github.com/PrefectHQ/prefect/pull/10678
-- Allow Python classes as flow/task type hints — https://github.com/PrefectHQ/prefect/pull/10711
-- Fix formatting of `SendgridEmail.to_emails` example in notifications API reference — https://github.com/PrefectHQ/prefect/pull/10669
-- Streamline Artifact search filters to match other pages in the Prefect UI - https://github.com/PrefectHQ/prefect-ui-library/pull/1689
-- Improve the mobile navigation in the Prefect UI — https://github.com/PrefectHQ/prefect/pull/10686
+
+- Avoid creating unpersisted blocks remotely —
+- Handling DST in `CronSchedules` —
+- Allow Python classes as flow/task type hints —
+- Fix formatting of `SendgridEmail.to_emails` example in notifications API reference —
+- Streamline Artifact search filters to match other pages in the Prefect UI -
+- Improve the mobile navigation in the Prefect UI —
### Documentation
-- Add object ACL documentation — https://github.com/PrefectHQ/prefect/pull/10695
-- Use better arrow icon for `Try Cloud` button — https://github.com/PrefectHQ/prefect/pull/10675
-- Improves bash output format in code blocks on concepts/agents page — https://github.com/PrefectHQ/prefect/pull/10680
-- Update concepts screen shots to reflect improved Prefect UI — https://github.com/PrefectHQ/prefect/pull/10670
-- Update event feed screenshot in concepts pages — https://github.com/PrefectHQ/prefect/pull/10685
-- Update Prefect Cloud index screenshots and remove Prefect Cloud quickstart — https://github.com/PrefectHQ/prefect/pull/10692
-- Add error summaries section to Prefect Cloud index — https://github.com/PrefectHQ/prefect/pull/10698
-- Clarify supported artifact types — https://github.com/PrefectHQ/prefect/pull/10706
-- Update Prefect Cloud pages screenshots — https://github.com/PrefectHQ/prefect/pull/10700
-- Fix broken links in events concept docs and variables guide — https://github.com/PrefectHQ/prefect/pull/10726
+
+- Add object ACL documentation —
+- Use better arrow icon for `Try Cloud` button —
+- Improves bash output format in code blocks on concepts/agents page —
+- Update concepts screen shots to reflect improved Prefect UI —
+- Update event feed screenshot in concepts pages —
+- Update Prefect Cloud index screenshots and remove Prefect Cloud quickstart —
+- Add error summaries section to Prefect Cloud index —
+- Clarify supported artifact types —
+- Update Prefect Cloud pages screenshots —
+- Fix broken links in events concept docs and variables guide —
### New Contributors
-* @odoublewen made their first contribution in https://github.com/PrefectHQ/prefect/pull/10706
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.13.0...2.13.1
+- @odoublewen made their first contribution in
+
+**All changes**:
## Release 2.13.0
### Introducing global concurrency limits
-Control task execution and system stability with Prefect's new global concurrency and rate limits.
+Control task execution and system stability with Prefect's new global concurrency and rate limits.
- **Concurrency Limits:** Manage task execution efficiently, controlling how many tasks can run simultaneously. Ideal for optimizing resource usage and customizing task execution.
@@ -859,13 +970,15 @@ Control task execution and system stability with Prefect's new global concurrenc
Choose concurrency limits for resource optimization and task management, and opt for rate limits to maintain system stability and fair access to services. To begin using global concurrency limits check out our [guide](https://docs.prefect.io/guides/global-concurrency-limits/).
See the following pull request for details:
-- https://github.com/PrefectHQ/prefect/pull/10496
+
+-
### Introducing work pool and worker status
Work pools and workers are critical components of Prefect's distributed execution model. To help you monitor and manage your work pools and workers, we've added status indicators to the Prefect UI.
Work pools can now have one of three statuses:
+
- `Ready` - at least one online worker is polling the work pool and the work pool is ready to accept work.
- `Not Ready` - no online workers are polling the work pool and indicates that action needs to be taken to allow the work pool to accept work.
- `Paused` - the work pool is paused and work will not be executed until it is unpaused.
@@ -873,6 +986,7 @@ Work pools can now have one of three statuses:
![Prefect dashboard showing work pool health](https://user-images.githubusercontent.com/12350579/265874237-7fae81e0-1b1a-460b-9fc5-92d969326d22.png)
Workers can now have one of two statuses:
+
- `Online` - the worker is polling the work pool and is ready to accept work.
- `Offline` - the worker is not polling the work pool and is not ready to accept work. Indicates that the process running the worker has stopped or crashed.
@@ -883,22 +997,26 @@ With the introduction of work pool and worker status, we are deprecating work qu
See the documentation on [work pool status](https://docs.prefect.io/latest/concepts/work-pools/#work-pool-status) and [worker status](https://docs.prefect.io/latest/concepts/work-pools/#worker-status) for more information.
See the following pull request for details:
-- https://github.com/PrefectHQ/prefect/pull/10636
-- https://github.com/PrefectHQ/prefect/pull/10654
+
+-
+-
### Removing deprecated Orion references
-Six months ago, we deprecated references to `orion` in our codebase. In this release, we're removing those references. If you still have references to `ORION` in your profile, run `prefect config validate` to automatically convert all of the settings in your *current* profile to the new names!
+Six months ago, we deprecated references to `orion` in our codebase. In this release, we're removing those references. If you still have references to `ORION` in your profile, run `prefect config validate` to automatically convert all of the settings in your _current_ profile to the new names!
For example:
+
```bash
❯ prefect config validate
Updated 'PREFECT_ORION_DATABASE_CONNECTION_URL' to 'PREFECT_API_DATABASE_CONNECTION_URL'.
Configuration valid!
```
-#### Below is a full guide to the changes:
-##### Settings renamed:
+#### Below is a full guide to the changes
+
+##### Settings renamed
+
- `PREFECT_LOGGING_ORION_ENABLED` → `PREFECT_LOGGING_TO_API_ENABLED`
- `PREFECT_LOGGING_ORION_BATCH_INTERVAL` → `PREFECT_LOGGING_TO_API_BATCH_INTERVAL`
- `PREFECT_LOGGING_ORION_BATCH_SIZE` → `PREFECT_LOGGING_TO_API_BATCH_SIZE`
@@ -933,7 +1051,9 @@ Configuration valid!
- `PREFECT_ORION_SERVICES_PAUSE_EXPIRATIONS_ENABLED` → `PREFECT_API_SERVICES_PAUSE_EXPIRATIONS_ENABLED`
- `PREFECT_ORION_TASK_CACHE_KEY_MAX_LENGTH` → `PREFECT_API_TASK_CACHE_KEY_MAX_LENGTH`
- `PREFECT_ORION_SERVICES_CANCELLATION_CLEANUP_ENABLED` → `PREFECT_API_SERVICES_CANCELLATION_CLEANUP_ENABLED`
-##### Changes:
+
+##### Changes
+
- Module `prefect.client.orion` → `prefect.client.orchestration`
- Command group `prefect orion` → `prefect server`
- Module `prefect.orion` → `prefect.server`
@@ -951,48 +1071,55 @@ Configuration valid!
- Class `OrionClient` → `PrefectClient`
See the following pull request for details:
-- Remove deprecated `orion` references — https://github.com/PrefectHQ/prefect/pull/10642
+
+- Remove deprecated `orion` references —
### Fixes
-- Fix an issue with `prefect server start` on Windows - https://github.com/PrefectHQ/prefect/pull/10547
+
+- Fix an issue with `prefect server start` on Windows -
### Documentation
-- Update deployment concept documentation to emphasize server-side deployment — https://github.com/PrefectHQ/prefect/pull/10615
-- Add Kubernetes guide for deploying worker to Azure AKS — https://github.com/PrefectHQ/prefect/pull/10575
-- Add information on `--no-prompt` and `PREFECT_CLI_PROMPT` to deployment documentation — https://github.com/PrefectHQ/prefect/pull/10600
-- Fix broken link to docker guide with redirect and harmonize naming — https://github.com/PrefectHQ/prefect/pull/10624
-- Remove invalid link in API keys documentation — https://github.com/PrefectHQ/prefect/pull/10658
-- Update screenshots and CLI log output in quickstart documentation — https://github.com/PrefectHQ/prefect/pull/10659
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.12.1...2.13.0
+- Update deployment concept documentation to emphasize server-side deployment —
+- Add Kubernetes guide for deploying worker to Azure AKS —
+- Add information on `--no-prompt` and `PREFECT_CLI_PROMPT` to deployment documentation —
+- Fix broken link to docker guide with redirect and harmonize naming —
+- Remove invalid link in API keys documentation —
+- Update screenshots and CLI log output in quickstart documentation —
+
+**All changes**:
## Release 2.12.1
This release includes some important fixes and enhancements. In particular, it resolves an issue preventing the flow run graph from rendering correctly in some cases.
### Enhancements
-- Reduce logging noise on QueueServices startup failures and item processing failures — https://github.com/PrefectHQ/prefect/pull/10564
-- Expose a setting for configuring a process limit on served flows — https://github.com/PrefectHQ/prefect/pull/10602
+
+- Reduce logging noise on QueueServices startup failures and item processing failures —
+- Expose a setting for configuring a process limit on served flows —
### Fixes
-- Improve failure recovery for websockets — https://github.com/PrefectHQ/prefect/pull/10597
-- Fix flow run graph rendering issues — https://github.com/PrefectHQ/prefect/pull/10606
+
+- Improve failure recovery for websockets —
+- Fix flow run graph rendering issues —
### Documentation
-- Update Docker guide to include with `flow.serve()` — https://github.com/PrefectHQ/prefect/pull/10596
+
+- Update Docker guide to include with `flow.serve()` —
### Contributors
-* @urimandujano made their first contribution in https://github.com/PrefectHQ/prefect/pull/10564
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.12.0...2.12.1
+- @urimandujano made their first contribution in
+
+**All changes**:
## Release 2.12.0
### Introducing `Flow.serve()`
-We're excited to introduce a radically simple way to deploy flows.
+We're excited to introduce a radically simple way to deploy flows.
-The new `.serve()` method available on every flow allows you to take your existing flows and schedule or trigger runs via the Prefect UI and CLI.
+The new `.serve()` method available on every flow allows you to take your existing flows and schedule or trigger runs via the Prefect UI and CLI.
This addition makes it easier than it's ever been to deploy flows with Prefect:
@@ -1026,11 +1153,11 @@ Running this script will start a process that will run the `hello` flow every ho
To start serving your flows, check out our newly updated [quickstart](https://docs.prefect.io/latest/getting-started/quickstart/) and [tutorial](https://docs.prefect.io/latest/tutorial/).
See the following pull requests for details:
-- https://github.com/PrefectHQ/prefect/pull/10534
-- https://github.com/PrefectHQ/prefect/pull/10549
-- https://github.com/PrefectHQ/prefect/pull/10574
-- https://github.com/PrefectHQ/prefect/pull/10585
+-
+-
+-
+-
### A fresh look and feel
@@ -1039,50 +1166,56 @@ The Prefect UI just got a fresh coat of paint! We've carefully updated colors th
![Updated Prefect UI in light and dark modes](https://github.com/PrefectHQ/prefect/assets/42048900/c526619c-22d3-44e6-82ee-255ae1233035)
See the following pull requests for implementation details:
-- https://github.com/PrefectHQ/prefect/pull/10546
-- https://github.com/PrefectHQ/prefect/pull/10578
-- https://github.com/PrefectHQ/prefect/pull/10584
-- https://github.com/PrefectHQ/prefect/pull/10583
-- https://github.com/PrefectHQ/prefect/pull/10588
+
+-
+-
+-
+-
+-
### Enhancements
-- Allow JSON infra overrides via `prefect deploy` — https://github.com/PrefectHQ/prefect/pull/10355
-- Improve validation for `Flow.name` — https://github.com/PrefectHQ/prefect/pull/10463
-- Add a Docker image for conda for Python 3.11 — https://github.com/PrefectHQ/prefect/pull/10532
-- Increase default `PREFECT_API_REQUEST_TIMEOUT` setting to 60 seconds — https://github.com/PrefectHQ/prefect/pull/10543
-- Remove missing work queue warning from the deployment page — https://github.com/PrefectHQ/prefect/pull/10550
-- Add `PREFECT_SQLALCHEMY_POOL_SIZE` and `PREFECT_SQLALCHEMY_MAX_OVERFLOW` settings to configure SQLAlchemy connection pool size — https://github.com/PrefectHQ/prefect/pull/10348
-- Improve format handling of `GitLab` and `Bitbucket` tokens during `git_clone` deployment step — https://github.com/PrefectHQ/prefect/pull/10555
-- Persist active tabs in Prefect UI pages upon refresh — https://github.com/PrefectHQ/prefect/pull/10544
-- Add ability to view subflows in the UI that are linked from `run_deployment` with `DaskTaskRunner` and `RayTaskRunner` — https://github.com/PrefectHQ/prefect/pull/10541
-- Improve CLI output for push work pools https://github.com/PrefectHQ/prefect/pull/10582
+
+- Allow JSON infra overrides via `prefect deploy` —
+- Improve validation for `Flow.name` —
+- Add a Docker image for conda for Python 3.11 —
+- Increase default `PREFECT_API_REQUEST_TIMEOUT` setting to 60 seconds —
+- Remove missing work queue warning from the deployment page —
+- Add `PREFECT_SQLALCHEMY_POOL_SIZE` and `PREFECT_SQLALCHEMY_MAX_OVERFLOW` settings to configure SQLAlchemy connection pool size —
+- Improve format handling of `GitLab` and `Bitbucket` tokens during `git_clone` deployment step —
+- Persist active tabs in Prefect UI pages upon refresh —
+- Add ability to view subflows in the UI that are linked from `run_deployment` with `DaskTaskRunner` and `RayTaskRunner` —
+- Improve CLI output for push work pools
### Fixes
-- Pin `anyio` to < 4 in `requirements.txt` — https://github.com/PrefectHQ/prefect/pull/10570
-- Add upper bounds to core requirements to prevent major version upgrades https://github.com/PrefectHQ/prefect/pull/10592
-- Fix race condition in concurrent subflow runs involving `AsyncWaiters` — https://github.com/PrefectHQ/prefect/pull/10533
-- Fix `cloud login` false success when `PREFECT_API_KEY` set as environment variable or expired — https://github.com/PrefectHQ/prefect/pull/8641
-- Fix ability to view deployments page tags on larger screens - https://github.com/PrefectHQ/prefect/pull/10566
-- Properly indent `docker-git` recipe `prefect.yaml` — https://github.com/PrefectHQ/prefect/pull/10519
-- Fix Slack community invitation link — https://github.com/PrefectHQ/prefect/pull/10509
+
+- Pin `anyio` to < 4 in `requirements.txt` —
+- Add upper bounds to core requirements to prevent major version upgrades
+- Fix race condition in concurrent subflow runs involving `AsyncWaiters` —
+- Fix `cloud login` false success when `PREFECT_API_KEY` set as environment variable or expired —
+- Fix ability to view deployments page tags on larger screens -
+- Properly indent `docker-git` recipe `prefect.yaml` —
+- Fix Slack community invitation link —
### Experimental
-- Serialize concurrency requests — https://github.com/PrefectHQ/prefect/pull/10545
+
+- Serialize concurrency requests —
### Documentation
-- Detail Kubernetes work pool usage in Kubernetes guide — https://github.com/PrefectHQ/prefect/pull/10516
-- Add quickstart documentation, simplify welcome page and API reference overview — https://github.com/PrefectHQ/prefect/pull/10520
-- Add block and agent-based deployments to leftside navigation — https://github.com/PrefectHQ/prefect/pull/10528
-- Add `Try Prefect Cloud` button to documentation header — https://github.com/PrefectHQ/prefect/pull/10537
-- Remove blank menu bar in documentation header — https://github.com/PrefectHQ/prefect/pull/10565
-- Fix link to guide on moving data to and from cloud providers — https://github.com/PrefectHQ/prefect/pull/10521
-- Shorten push work pools description in guides index — https://github.com/PrefectHQ/prefect/pull/10589
-- Organize guides index into sections: Development, Execution, Workers and Agents, and Other Guides — https://github.com/PrefectHQ/prefect/pull/10587
+
+- Detail Kubernetes work pool usage in Kubernetes guide —
+- Add quickstart documentation, simplify welcome page and API reference overview —
+- Add block and agent-based deployments to leftside navigation —
+- Add `Try Prefect Cloud` button to documentation header —
+- Remove blank menu bar in documentation header —
+- Fix link to guide on moving data to and from cloud providers —
+- Shorten push work pools description in guides index —
+- Organize guides index into sections: Development, Execution, Workers and Agents, and Other Guides —
### Contributors
+
- @mattklein
-**All changes**: https://github.com/PrefectHQ/prefect/compare/2.11.5...2.12.0
+**All changes**: