Skip to main content

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 bus event handling topic.

Messages events

Git File

Event git.file.get

Description: Read a file from a Git repository.

Priority: 4

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
commitThe commit id to use to access the filestringNone
fileThe path and filename within the repositorystringNone
repository_idThe unique ID of the RepositorystringNone
repository_nameThe name of the repositorystringNone
repository_kindThe kind of the repositorystringNone

Git Repository

Event git.repository.connectivity

Description: Validate connectivity and credentials to remote repository

Priority: 3

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
repository_nameThe name of the repositorystringNone
repository_locationThe location of repositorystringNone

Refresh Git

Event refresh.git.fetch

Description: Fetch a repository remote changes.

Priority: 3

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
locationThe external URL of the repositorystringNone
repository_idThe unique ID of the repositorystringNone
repository_nameThe name of the repositorystringNone
repository_kindThe type of repositorystringNone
infrahub_branch_nameInfrahub branch on which to sync the remote repositorystringNone
infrahub_branch_idId of the Infrahub branch on which to sync the remote repositorystringNone

Refresh Registry

Event refresh.registry.branches

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

Priority: 3

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone

Event refresh.registry.rebased_branch

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

Priority: 3

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
branchThe branch that was rebasedstringNone

Send Echo

Event send.echo.request

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

Priority: 5

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
messageThe message to sendstringNone

Responses events

Git File

Event git.file.get

Priority: 4

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
passedN/AbooleanTrue
routing_keyN/Astringgit.file.get
data.contentN/AN/ANone
data.error_messageN/AN/ANone
data.http_codeN/AN/ANone
errorsN/AarrayNone
initial_messageInitial message in dict format, the primary goal of this field is to provide additional context when there is an errorN/ANone

Send Echo

Event send.echo.request

Priority: 5

KeyDescriptionTypeDefault Value
metaMeta properties for the messageN/ANone
passedN/AbooleanTrue
routing_keyN/Astringsend.echo.request
data.responseThe response stringstringNone
errorsN/AarrayNone
initial_messageInitial message in dict format, the primary goal of this field is to provide additional context when there is an errorN/ANone