Metadata API implements a GraphQL API that provides a way to manage and control metadata for all resources in the Graph using GraphQL queries and mutations.
ID fields between objects are not shown
erDiagram
NODE ||--o| Metadata : "has"
Metadata {
id nodeID
}
Metadata ||--o{ Annotation : "has"
Annotation {
json Data
}
Annotation }o--|| Annotation-Namespace : "belongs to"
Annotation-Namespace {
string Name
id OwnerID
}
Metadata ||--o{ Status : "has"
Status {
string Source
json Data
}
Status }o--|| Status-Namespace : "belongs to"
Status-Namespace {
string Name
id ResourceProviderID
}
Metadata is a top level structure that provides the connection to all metadata types for a Node. Any Graph Node that implements the MetadataNode interface can have metadata on it.
Annotation Namespaces provide the ability to create a namespace that annotations can be stored in. A namespace is meant to store only one type of data. For example if you wanted to store custom data about the version of your OS on every instance you could create a namespace called os-info. We recommend that you use the format of domain-name/name, so for OS info it would be nicole.dev/os-info for example. This isn't required but will prevent conflicts between services that use namespaces storing the same key of data. An annotation namespace is scoped to a tenant and can be set as private. When a namespace is marked private, you can only view data in this namespace if you have permissions to view private namespaces on the tenant the namespace belongs to.
Annotations store the actually data for a node. The data stored on an annotation is a JSON field that accepts any valid JSON. So continuing the previous example, for our os info namespace we might store data that looks like {"os": "Ubuntu 22.04", "family": "Ubuntu", "kernel": {"version": "5.10", "family": "Linux"}}. The field supports any level of nesting of the data that the user wishes to perform.
Status Namespaces are similar to Annotation Namespaces except they belong to a Resource Provider instead of a Tenant. This allows us to limit which status fields a resource provider can update.
Statuses store data the same way that Annotations do. Because a status field may need to be reported from multiple sources we provide a source field to allow the same namespace to be used for statuses. An example of where this would be important is for a LoadBalancer you may have it running in multiple locations. As such you will want to report each location with it's own status and be able to track those independently.
To begin start by opening the devcontainer as outlined in the Development Guide
To initialize the database:
go build./metadata-api migrate up
To run the api
make go-runInteracting with the GraphQL queries:
Go to localhost:XXXX/playground
Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
To contact the maintainers, please open a GitHub Issue