GIT Connection¶

The GIT connection type enables the GIT Integrations.

Authenticating to GIT¶

Authenticate to GIT using GitPython. The hook supports both HTTPS (token-based) and SSH (key-based) authentication.

Default Connection IDs¶

Hooks and bundles related to GIT use git_default by default.

Configuring the Connection¶

Repository URL

The URL of the git repository, e.g. git@github.com:apache/airflow.git for SSH or https://github.com/apache/airflow.git for HTTPS. This can also be passed directly to the hook via the repo_url parameter.

Username or Access Token name (optional)

The username for HTTPS authentication or the token name. Defaults to user if not specified. When using HTTPS with an access token, this value is used as the username in the authenticated URL (e.g. https://user:token@github.com/repo.git).

Access Token (optional)

The access token for HTTPS authentication. When provided along with the username, the hook injects the credentials into the repository URL for HTTPS cloning.

Extra (optional)

Specify the extra parameters as a JSON dictionary. The following keys are supported:

key_file: Path to an SSH private key file to use for authentication.
private_key: An inline SSH private key string. When provided, the hook writes it to a temporary file and uses it for the SSH connection.
strict_host_key_checking: Controls SSH strict host key checking. Defaults to no. Set to yes to enable strict checking.

Example:

{
    "key_file": "/path/to/id_rsa",
    "strict_host_key_checking": "no"
}

Or with an inline private key:

{
    "private_key": "<content of your PEM-encoded private key>"
}