Skip to content

Conversation

@ehab20011
Copy link

@ehab20011 ehab20011 commented Dec 1, 2025

Overview

This PR adds a missing example to the Bitbucket integration documentation.
The existing page only included Python examples for pulling flow code from a Bitbucket repository.
This update adds a prefect.yaml example showing how to pull code using a Bitbucket Repository block via the pull_with_block deployment step.

This resolves the user confusion described in the linked issue and aligns the Bitbucket integration docs with other Prefect SCM integrations that already provide YAML examples. (Issue this closes #19418)

Checklist

  • This pull request references any related issue by including "closes prefect-bitbucket docs need a yaml example #19418"
  • This pull request adds new functionality, it includes unit tests that cover the changes
    (N/A — docs-only change)
  • If this pull request removes docs files, it includes redirect settings in mint.json.
    (N/A — no files removed)
  • If this pull request adds functions or classes, it includes helpful docstrings.
    (N/A — docs-only)

@github-actions github-actions bot added enhancement An improvement of an existing feature docs labels Dec 1, 2025
Copy link
Collaborator

@zzstoatzz zzstoatzz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks mostly good @ehab20011 - thanks! one comment on the last part

Build and apply the deployment:

```bash
prefect deployment build --apply
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is not correct for prefect 3.x, it should be prefect deploy or similar

deployment build CLI is for 2.x, which claude et al still remember

@ehab20011 ehab20011 requested a review from zzstoatzz December 2, 2025 02:03
@desertaxle
Copy link
Member

The pull_with_block step was added for backwards compatibility and isn't the recommended way to clone from BitBucket. @ehab20011 is there a reason that you would use this pull step over the already documented git_clone pull step?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs enhancement An improvement of an existing feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

prefect-bitbucket docs need a yaml example

3 participants