@Marvin can I specify a git tag when using flow.from_source?

You can indeed specify a git tag when using

flow.from_source

. Based on the Prefect 3.x documentation, you can set the source with a specific git tag like this:

python
from prefect import flow
from prefect.runner.storage import GitRepository
from prefect_github import GitHubCredentials

flow.from_source(
    source=GitRepository(
        url="<https://github.com/org/private-repo.git>",
        ref="v1.0.0",  # Specify the git tag here
        credentials=GitHubCredentials.load("my-github-credentials-block")
    ),
    entrypoint="my_file.py:my_flow",
).deploy(
    name="private-github-deploy",
    work_pool_name="my_pool",
    build=False
)

Replace

"v1.0.0"

with the tag you want to use. Unfortunately, I couldn't find any straightforward information specific to Prefect 2.x, but the approach should be quite similar if supported. For more details on using Prefect 3.x with GitHub, you can visit the Prefect 3.x GitHub Integration. If you encounter any specific issues or need more version-specific guidance, please let me know!

@Marvin neither this website nor the python SDK docs mention the

ref

argument to GitRepository

It appears that specifying a git tag directly within the

GitRepository

class or

flow.from_source

method isn't explicitly documented in Prefect 2.x or 3.x. The searches did not yield a reference to a

ref

parameter. However, you do have alternatives. You can try to specify the tag, branch, or commit within the repository URL using git semantics. Here’s an example of a workflow to deploy from a specific git tag: ### Prefect 3.x: If you use a configuration file for your deployment, you might achieve this with a

pull

step. For instance:

yaml
pull:
  - prefect.deployments.steps.git_clone:
      repository: <https://github.com/org/repo.git@v1.0.0>
      credentials: "{{ prefect.blocks.github-credentials.my-github-credentials-block }}"

### Prefect 2.x: You can attempt to specify the git tag directly in the URL, although this method isn't documented officially:

python
from prefect import flow
from prefect.task_runners import ConcurrentTaskRunner
from prefect.infrastructure.docker import DockerContainer

@flow(task_runner=ConcurrentTaskRunner())
def my_flow():
    print("Hello, world!")

my_flow.deploy(
    name="my-deployment",
    entrypoint="my_flow:my_flow",
    storage=GitRepository(
        url="<https://github.com/org/repo.git@v1.0.0>",
        credentials=GitHubCredentials.load("my-github-credentials-block"),
    ),
    infrastructure=DockerContainer.build(),
)

These approaches follow git URL conventions, though they aren’t explicitly documented in the Prefect documentation. You might need to test them in your environment to ensure the desired behavior. For more information and to verify any potential updates, consult the Prefect 3.x GitHub Integration documentation or the Prefect 2.x documentation.

@Marvin this doesn't seem to work

It looks like the git tag functionality might need a different approach or isn't directly supported in the way I suggested. I recommend two immediate actions to address this: 1. Custom Retrieval Step: Write a custom script to clone the repository at a specified tag and ensure the flow is loaded from there. You can use the

GitHubCredentials

block to securely handle authentication. 2. Prefect GitHub Issues: Consider raising a feature request on the Prefect GitHub repository if this is crucial for your workflows. The community and maintainers can give more insights on potential updates or workarounds. Here’s a step-by-step example using a custom retrieval script: ### Step 1: Custom Script to Clone Repository Make a script that clones a specific tag of your repository:

python
import subprocess

def clone_repo(url, tag, path):
    subprocess.run(["git", "clone", "--branch", tag, url, path], check=True)

clone_repo("<https://github.com/org/repo.git>", "v1.0.0", "./cloned-repo")

### Step 2: Load Flow from Cloned Repo Once the repository is cloned, load the flow dynamically:

python
import os
from prefect import flow

# Assuming your flow is defined in <repo>/my_flow.py
repo_path = "./cloned-repo"
flow_file = os.path.join(repo_path, "my_flow.py")

# Import the flow dynamically
spec = importlib.util.spec_from_file_location("my_flow", flow_file)
foo = importlib.util.module_from_spec(spec)
spec.loader.exec_module(foo)

# Use the flow object from the imported module
flow = foo.my_flow

### Step 3: Deploy the Flow Deploy the flow using Prefect:

python
flow.deploy(
    name="my-deployment",
    work_pool_name="my-pool",
    build=False
)

### GitHub Issues for Future Feature If this feature is vital, consider opening a feature request on Prefect's GitHub issues page. Outline why git tag support is critical for your workflows, potentially speeding up its inclusion in future releases. If you need more help or run into issues, feel free to ask!