You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/vendor/replicated-sdk-values-schema.md
+42-34Lines changed: 42 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,3 @@
1
-
2
-
import HelmDiagramOverview from "../partials/helm/_helm-diagram-overview.mdx"
3
-
import DependencyYaml from "../partials/replicated-sdk/_dependency-yaml.mdx"
4
-
5
1
# Helm global.replicated Values Schema
6
2
7
3
This document describes the global.replicated values schema injected by the Replicated registry when using the Helm CLI installation method. It includes information on the structure and purpose of fields to help developers integrate seamlessly with the Replicated SDK.
@@ -23,7 +19,7 @@ The `global.replicated` values schema is a set of values that are injected by th
23
19
|`image.repository`| String | The name of the replicated/replicated-sdk image repository. |
24
20
|`image.tag`| String | The tag of the replicated/replicated-sdk image. |
25
21
|`image.pullPolicy`| String | The Kubernetes image pull policy for the replicated/replicated-sdk image. |
26
-
|`license`| String | The license ID of customer. |
22
+
|`license`| String | The yaml representation of the customer license. |
27
23
|`licenseFields`| string | The license fields of the customer. |
28
24
|`appName`| String | The name of the application, as specified in the Replicated Vendor Portal. |
29
25
|`channelID`| String | The unique ID of the release channel. |
@@ -66,38 +62,50 @@ The `global.replicated` values schema is a set of values that are injected by th
66
62
|`tolerations`| Array | The tolerations for the pod. |
67
63
|`affinity`| Object | The affinity for the pod. |
68
64
65
+
## license Values Schema
69
66
70
-
## Using Replicated Registry Values
71
-
With the Replicated proxy registry, each customer’s license information is injected into the application’s environment and grant proxy access to images in an external private registry.
72
-
To use the Replicated registry values, you must first configure the Replicated proxy registry in your Kubernetes cluster. For more information, see [Replicated Proxy Registry](/vendor/replicated-proxy-registry).
73
-
74
-
Here is an example of how to use the `global.replicated` values schema in your application:
67
+
The `license` field in the `global.replicated` values schema is a string that contains the YAML representation of the customer license. The license schema is a yaml object that contains the following fields:
In your deployment manifest, you can reference the `global.replicated` values schema to access the license information and other values injected by the Replicated registry.
85
-
```yaml
86
-
# /templates/deployment.yaml
87
-
88
-
apiVersion: apps/v1
89
-
kind: Deployment
70
+
apiVersion: kots.io/v1beta1
71
+
kind: License
90
72
metadata:
91
-
name: example
73
+
name: name of the license
92
74
spec:
93
-
template:
94
-
spec:
95
-
containers:
96
-
- name: api
97
-
# Access the apiImageRepository field from the values file
{{ if .Values.global.replicated.dockerconfigjson }}
100
-
imagePullSecrets:
101
-
- name: replicated-pull-secret
102
-
{{ end }}
75
+
appSlug: The unique application slug that the customer is associated with. This value never changes.
76
+
channelID: The ID of the channel where the customer is assigned.
77
+
channelName: The name of the channel where the customer is assigned.
78
+
channels:
79
+
- channelID: The ID of the channel where the customer is assigned.
80
+
channelName: The name of the channel where the customer is assigned.
81
+
channelSlug: The unique channel slug.
82
+
endpoint: The default Replicated App endpoint https://replicated.app
83
+
replicatedProxyDomain: The domain of Replicated Proxy Registry.
84
+
customerEmail: The customer email address.
85
+
customerName: The name of the customer.
86
+
endpoint: This is the endpoint that the KOTS Admin Console uses to synchronize the licenses and download updates.
87
+
entitlements:
88
+
expires_at:
89
+
description: License Expiration
90
+
signature: {}
91
+
title: Expiration
92
+
value: ""
93
+
valueType: String
94
+
isAirgapSupported: If a license supports air gap installations with the Replicated installers (KOTS, kURL, Embedded Cluster), then this field is set to true.
95
+
isDisasterRecoverySupported: If a license supports the Embedded Cluster disaster recovery feature, this field is set to true.
96
+
isEmbeddedClusterDownloadEnabled: If a license supports installation with Replicated Embedded Cluster, this field is set to true or missing.
97
+
isKotsInstallEnabled: If a license supports installation with Replicated KOTS, this field is set to true.
98
+
isSnapshotSupported: If a license supports the snapshots backup and restore feature, this field is set to true.
99
+
isSupportBundleUploadSupported: If a license supports uploading a support bundle in the Admin Console, this field is set to true.
100
+
licenseID: Unique ID for the installed license. This value never changes.
101
+
licenseSequence: This value represents the license sequence that the client currently has.
102
+
licenseType: A string value that describes the type of the license
103
+
replicatedProxyDomain: proxy.replicated.com
104
+
signature: The base64-encoded license signature. This value will change when the license is updated.
105
+
parentChartURL: The URL of the parent Helm chart if the application is nested in a chart hierarchy.
106
+
releaseCreatedAt: The timestamp when the release was created.
107
+
releaseNotes: Release notes for the current release, as provided in the Vendor Portal.
108
+
releaseSequence: The sequence number of the release associated with this deployment.
0 commit comments