Message bus events

This document provides detailed documentation for all events used in the Infrahub message bus system.

info

For more detailed explanations on how these events are used within Infrahub, see the event system documentation.

Messages events

Git File

Event git.file.get

Description: Read a file from a Git repository.

Priority: 4

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
commit	The commit id to use to access the file	string	None
file	The path and filename within the repository	string	None
repository_id	The unique ID of the Repository	string	None
repository_name	The name of the repository	string	None
repository_kind	The kind of the repository	string	None

Git Repository

Event git.repository.connectivity

Description: Validate connectivity and credentials to remote repository.

Priority: 3

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
repository_name	The name of the repository	string	None
repository_location	The location of repository	string	None

Refresh Git

Event refresh.git.fetch

Description: Fetch a repository remote changes.

Priority: 3

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
location	The external URL of the repository	string	None
repository_id	The unique ID of the repository	string	None
repository_name	The name of the repository	string	None
repository_kind	The type of repository	string	None
infrahub_branch_name	Infrahub branch on which to sync the remote repository	string	None
infrahub_branch_id	Id of the Infrahub branch on which to sync the remote repository	string	None

Event refresh.git.branch_deleted

Description: Notify workers that a branch was deleted from the remote repository.

Priority: 3

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
repository_id	The unique ID of the repository	string	None
repository_name	The name of the repository	string	None
repository_kind	The type of repository	string	None
branch_name	The name of the branch that was deleted	string	None

Refresh Registry

Event refresh.registry.branches

Description: Sent to indicate that the registry should be refreshed and new branch data loaded.

Priority: 3

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None

Event refresh.registry.rebased_branch

Description: Sent to refresh a rebased branch within the local registry.

Priority: 3

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
branch	The branch that was rebased	string	None

Send Echo

Event send.echo.request

Description: Sent a echo request, a ping message for example.

Priority: 5

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
message	The message to send	string	None

Responses events

Git File

Event git.file.get

Priority: 4

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
passed	N/A	boolean	True
routing_key	N/A	string	git.file.get
data.content	N/A	N/A	None
data.error_message	N/A	N/A	None
data.http_code	N/A	N/A	None
errors	N/A	array	None
initial_message	Initial message in dict format, the primary goal of this field is to provide additional context when there is an error	N/A	None

Send Echo

Event send.echo.request

Priority: 5

Key	Description	Type	Default Value
meta	Meta properties for the message	N/A	None
passed	N/A	boolean	True
routing_key	N/A	string	send.echo.request
data.response	The response string	string	None
errors	N/A	array	None
initial_message	Initial message in dict format, the primary goal of this field is to provide additional context when there is an error	N/A	None