schema/schema.graphql

@@ -63,6 +63,12 @@ type RootQueryType {
 
   secrets(namespace: String!): [Secret]
 
+  pluralCluster(namespace: String!, name: String!, serviceId: ID): PluralCluster
+
+  pluralServiceDeployment(namespace: String!, name: String!, serviceId: ID): PluralServiceDeployment
+
+  pluralGitRepository(namespace: String!, name: String!, serviceId: ID): PluralGitRepository
+
   unstructuredResource(group: String, version: String!, kind: String!, namespace: String, name: String!, serviceId: ID): KubernetesUnstructured
 
   service(namespace: String!, name: String!, serviceId: ID): Service
@@ -167,7 +173,7 @@ type RootQueryType {
   tokenExchange(token: String!): User
 
   "a relay connection of all clusters visible to the current user"
-  clusters(after: String, first: Int, before: String, last: Int, q: String, health: Boolean, tag: TagInput): ClusterConnection
+  clusters(after: String, first: Int, before: String, last: Int, q: String, healthy: Boolean, tag: TagInput): ClusterConnection
 
   "gets summary information for all healthy\/unhealthy clusters in your fleet"
   clusterStatuses(q: String, tag: TagInput): [ClusterStatusInfo]
@@ -187,6 +193,9 @@ type RootQueryType {
   "list all addons currently resident in the artifacts repo"
   clusterAddOns: [ClusterAddOn]
 
+  "fetch an individual runtime service for more thorough detail views"
+  runtimeService(id: ID!): RuntimeService
+
   serviceDeployments(
     after: String
 
@@ -935,6 +944,7 @@ input ServiceDeploymentAttributes {
   syncConfig: SyncConfigAttributes
   protect: Boolean
   repositoryId: ID
+  dryRun: Boolean
   git: GitRefAttributes
   helm: HelmConfigAttributes
   kustomize: KustomizeAttributes
@@ -952,6 +962,7 @@ input HelmConfigAttributes {
   valuesFiles: [String]
   chart: String
   version: String
+  set: HelmValueAttributes
   repository: NamespacedName
 }
 
@@ -960,6 +971,14 @@ input MetadataAttributes {
   annotations: Json
 }
 
+input HelmValueAttributes {
+  "helm value name, can be deeply nested via dot like `image.tag`"
+  name: String
+
+  "value of the attribute"
+  value: String
+}
+
 input ServiceUpdateAttributes {
   version: String
   protect: Boolean
@@ -993,6 +1012,15 @@ input ComponentAttributes {
   kind: String!
   namespace: String!
   name: String!
+  content: ComponentContentAttributes
+}
+
+"the content of a component when visualized in dry run state"
+input ComponentContentAttributes {
+  "the desired state of a service component as determined from the configured manifests"
+  desired: String
+
+  live: String
 }
 
 input ServiceErrorAttributes {
@@ -1037,6 +1065,9 @@ type ServiceDeployment {
   "semver of this service"
   version: String!
 
+  "the desired sync interval for this service"
+  interval: String
+
   "description on where in git the service's manifests should be fetched"
   git: GitRef
 
@@ -1070,6 +1101,9 @@ type ServiceDeployment {
   "the time this service was scheduled for deletion"
   deletedAt: DateTime
 
+  "whether this service should not actively reconcile state and instead simply report pending changes"
+  dryRun: Boolean
+
   "fetches the \/docs directory within this services git tree.  This is a heavy operation and should NOT be used in list queries"
   docs: [GitFile]
 
@@ -1168,6 +1202,9 @@ type HelmSpec {
   "the chart version in use currently"
   version: String
 
+  "a list of helm name\/value pairs to precisely set individual values"
+  set: [HelmValue]
+
   "a list of relative paths to values files to use for helm applies"
   valuesFiles: [String]
 }
@@ -1178,6 +1215,12 @@ type ServiceConfiguration {
   value: String!
 }
 
+"a (possibly nested) helm value pair"
+type HelmValue {
+  name: String!
+  value: String!
+}
+
 "metadata needed for configuring kustomize"
 type Kustomize {
   path: String!
@@ -1209,13 +1252,30 @@ type ServiceComponent {
   "kubernetes name of this resource"
   name: String!
 
+  "the live and desired states of this service component"
+  content: ComponentContent
+
   "the service this component belongs to"
   service: ServiceDeployment
 
   "any api deprecations discovered from this component"
   apiDeprecations: [ApiDeprecation]
 }
 
+"dry run content of a service component"
+type ComponentContent {
+  id: ID!
+
+  live: String
+
+  "the inferred desired state of this component"
+  desired: String
+
+  insertedAt: DateTime
+
+  updatedAt: DateTime
+}
+
 "a representation of a kubernetes api deprecation"
 type ApiDeprecation {
   "the kubernetes version the deprecation was posted"
@@ -1816,6 +1876,15 @@ type RuntimeAddon {
   "an icon to identify this runtime add-on"
   icon: String
 
+  "the url to the add-ons git repository"
+  gitUrl: String
+
+  "the add-on's readme, this is a heavy operation that should not be performed w\/in lists"
+  readme: String
+
+  "the release page for a runtime service at a version, this is a heavy operation not suitable for lists"
+  releaseUrl(version: String!): String
+
   versions: [AddonVersion]
 }
 
@@ -1833,6 +1902,9 @@ type AddonVersion {
   "any add-ons this might break"
   incompatibilities: [VersionReference]
 
+  "the release page for a runtime service at a version, this is a heavy operation not suitable for lists"
+  releaseUrl(version: String!): String
+
   "checks if this is blocking a specific kubernetes upgrade"
   blocking(kubeVersion: String!): Boolean
 }
@@ -2496,6 +2568,35 @@ type ApplicationDelta {
   payload: Application
 }
 
+type PluralCluster {
+  status: PluralObjectStatus!
+  metadata: Metadata!
+  reference: Cluster
+  raw: String!
+  events: [Event]
+}
+
+type PluralServiceDeployment {
+  status: PluralObjectStatus!
+  metadata: Metadata!
+  reference: ServiceDeployment
+  raw: String!
+  events: [Event]
+}
+
+type PluralGitRepository {
+  status: PluralObjectStatus!
+  metadata: Metadata!
+  reference: GitRepository
+  raw: String!
+  events: [Event]
+}
+
+type PluralObjectStatus {
+  id: String
+  conditions: [StatusCondition]
+}
+
 type DaemonSet {
   metadata: Metadata!
   status: DaemonSetStatus!