diff --git a/docs/3.0/deploy/infrastructure-concepts/work-pools.mdx b/docs/3.0/deploy/infrastructure-concepts/work-pools.mdx index 92f8d43bbff2..0e7417a0a56b 100644 --- a/docs/3.0/deploy/infrastructure-concepts/work-pools.mdx +++ b/docs/3.0/deploy/infrastructure-concepts/work-pools.mdx @@ -83,6 +83,9 @@ flowchart LR E -.-> F ``` +There are no changes between the original content and the proposed changes. Therefore, the content remains the same. + +``` ### Work pool configuration You can configure work pools by using any of the following: @@ -144,7 +147,7 @@ Optional configuration parameters you can specify to update the work pool includ ``` - +``` ### Work pool types The following work pool types are supported by Prefect: @@ -412,6 +415,7 @@ Learn more about [customizing job variables](/3.0/deploy/infrastructure-concepts **Advanced customization of the base job template** + For advanced use cases, create work pools with fully customizable job templates. This customization is available when creating or editing a work pool on the 'Advanced' tab within the UI or when updating a work pool via the Prefect CLI. @@ -474,7 +478,7 @@ in waterfall fashion. Unpausing a work queue gives the work queue a `NOT_READY` status unless a worker has polled it in the last 60 seconds. -## Next steps +## Next steps - Learn more about [workers](/3.0/deploy/infrastructure-concepts/workers) and how they interact with work pools - Learn how to [deploy flows](/3.0/deploy/infrastructure-concepts/prefect-yaml) that run in work pools diff --git a/docs/3.0/deploy/infrastructure-concepts/workers.mdx b/docs/3.0/deploy/infrastructure-concepts/workers.mdx index 9ac6379e8698..ad7e7d8d68ca 100644 --- a/docs/3.0/deploy/infrastructure-concepts/workers.mdx +++ b/docs/3.0/deploy/infrastructure-concepts/workers.mdx @@ -143,6 +143,7 @@ For example, to limit a worker to five concurrent flow runs: prefect worker start --pool "my-pool" --limit 5 ``` +If the work pool already has active workers, the CLI will not display instructions to start new workers, optimizing the deployment process. ### Configure prefetch By default, the worker submits flow runs a short time (10 seconds) before they are scheduled to run. diff --git a/docs/3.0/deploy/infrastructure-examples/docker.mdx b/docs/3.0/deploy/infrastructure-examples/docker.mdx index 73fe40da6c04..bf5687c46421 100644 --- a/docs/3.0/deploy/infrastructure-examples/docker.mdx +++ b/docs/3.0/deploy/infrastructure-examples/docker.mdx @@ -60,7 +60,7 @@ Run the following command in this new terminal to start the worker: prefect worker start --pool my-docker-pool ``` -You should see the worker start. +If there are no active workers in your work pool, you should see the worker start. It's now polling the Prefect API to check for any scheduled flow runs it should pick up and then submit for execution. You'll see your new worker listed in the UI under the **Workers** tab of the Work Pools page with a recent last polled date. The work pool should have a `Ready` status indicator. diff --git a/docs/3.0/resources/upgrade-agents-to-workers.mdx b/docs/3.0/resources/upgrade-agents-to-workers.mdx index 4ad1d5738595..b70b06ac50a6 100644 --- a/docs/3.0/resources/upgrade-agents-to-workers.mdx +++ b/docs/3.0/resources/upgrade-agents-to-workers.mdx @@ -32,6 +32,7 @@ from that pool. - Improved visibility into the status of each worker, including when a worker was started and when it last polled. - Better handling of race conditions for high availability use cases. +- Worker filtering by status to manage active workers efficiently during deployments. ### Work pools @@ -52,6 +53,10 @@ with a single command. - The YAML-based API supports [templating](/3.0/deploy/infrastructure-concepts/prefect-yaml/#templating-options) to enable [dryer deployment definitions](/3.0/deploy/infrastructure-examples/docker/#reusing-configuration-across-deployments). +### Deployment logic enhancements + +- Deployment instructions are now conditional based on the presence of active workers, preventing unnecessary setup prompts and streamlining the deployment process. + ## Upgrade changes 1. **Deployment CLI and Python SDK:** @@ -88,6 +93,12 @@ to enable [dryer deployment definitions](/3.0/deploy/infrastructure-examples/doc file or use the [`deploy`](/3.0/deploy/infrastructure-examples/docker) function. +5. **Worker management in deployments:** + + The deployment process now checks for active workers in the work pool before displaying instructions + to start new workers. This enhancement ensures that deployment instructions are relevant to the current + state of the work pool, reducing unnecessary prompts and improving user guidance. + ## What's similar - You can set storage blocks as the pull action in a `prefect.yaml` file.