Skip to main content

Ways to interface with Infra Sync Tracker

Infra Sync Tracker interfaces

Managing infrastructure at scale often means many people, teams, workflows and other systems must interact with the Infra Sync Tracker infrastructure management platform. Infra Sync Tracker provides multiple methods to interact:

WebUI​

  • By default, exposed on TCP port 8000
  • Built-in documentation
  • Global search, including searching data and documentation
  • A GraphQL sandbox
  • Swagger documentation for the REST API

GraphQL API​

GraphQL is the primary API to interact with data, and allows access to everything defined by the schema. The Python SDK is built on top of the GraphQL API.

  • By default, exposed on TCP port 8000 at the endpoint: http://<API_SERVER_IP>:8000/graphql
  • The Frontend utilizes the GraphQL API for most tasks
  • More information can be found in the GraphQL topic

REST API​

GraphQL can only accept a query in string format and returns JSON, so there are certain workflows that are available via the REST API.

  • Loading the schema
  • Retrieving artifacts
  • Accessing the object store
  • Executing a saved GraphQL query

The REST API has the following properties:

  • By default, exposed on TCP port 8000 at the endpoint: http://<API_SERVER_IP>:8000/api
  • Swagger docs can be found at: http://<API_SERVER_IP>:8000/api/docs

infrahubctl​

infrahubctl is a command line utility designed to help with the day to day management of an Infra Sync Tracker installation. It's meant to run on any laptop or server and it communicates with a remote Infra Sync Tracker server over the network.

More information can be found in the infrahubctl documentation section.

Python SDK​

The Infra Sync Tracker Python SDK greatly simplifies how you can interact with Infra Sync Tracker programmatically.

More information can be found in the Python SDK documentation section.

Git​

One of the three pillars Infra Sync Tracker is built on is the idea of having unified storage for data and files. The data is stored in the graph database and the files are stored in Git.

When integrating a Git repository with Infra Sync Tracker, the Task worker will ensure that both systems stay in sync at any time. Changes to branches or files in a Git repository will be synced to Infra Sync Tracker automatically.

More information can be found in the external repositories guide