Skip to content

Commit

Permalink
Docs update (903e1a3)
Browse files Browse the repository at this point in the history
  • Loading branch information
promptless[bot] authored Nov 15, 2024
1 parent c4f0feb commit 7a14cec
Show file tree
Hide file tree
Showing 4 changed files with 19 additions and 3 deletions.
8 changes: 6 additions & 2 deletions docs/3.0/deploy/infrastructure-concepts/work-pools.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -144,7 +147,7 @@ Optional configuration parameters you can specify to update the work pool includ
```
</Tip>


```
### Work pool types
The following work pool types are supported by Prefect:
Expand Down Expand Up @@ -412,6 +415,7 @@ Learn more about [customizing job variables](/3.0/deploy/infrastructure-concepts
<Tip>
**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.
Expand Down Expand Up @@ -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.
</Tip>

## 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
Expand Down
1 change: 1 addition & 0 deletions docs/3.0/deploy/infrastructure-concepts/workers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion docs/3.0/deploy/infrastructure-examples/docker.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
11 changes: 11 additions & 0 deletions docs/3.0/resources/upgrade-agents-to-workers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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:**
Expand Down Expand Up @@ -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.
Expand Down

0 comments on commit 7a14cec

Please sign in to comment.