|
1 | 1 | # Helm global.replicated Values Schema |
2 | 2 |
|
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. |
| 3 | +This document describes the values injected by the Replicated registry when using the Helm CLI installation method. It describes the structure and purpose of fields to help developers integrate seamlessly with the Replicated SDK. |
4 | 4 |
|
5 | 5 | ## Overview |
6 | 6 |
|
7 | | -The `global.replicated` values schema is a set of values that are injected by the Replicated registry when using the Helm CLI installation method. These values are used by the Replicated SDK to provide information about the replicated application and the environment in which it is running. These values are critical for licensing, release management, and enabling key features of the Replicated Vendor Portal. |
| 7 | +When a user installs a Helm application using the Helm CLI, the Replicated registry injects a set of customer-specific values into the `replicated` and `global.replicated` keys. |
8 | 8 |
|
9 | 9 | For additional information about the Replicated SDK, see [Replicated SDK Overview](/vendor/replicated-sdk-overview). |
10 | 10 |
|
11 | 11 | ## Values Schema Structure |
12 | 12 |
|
13 | | -The `global.replicated` values schema is a set of values that are injected by the Replicated registry when using the Helm CLI installation method. The schema is a JSON object that contains the following fields: |
| 13 | +The `replicated` schema contains the following fields: |
14 | 14 |
|
15 | 15 | | Field | Type | Description | |
16 | 16 | | --- | --- | --- | |
17 | | -| `global.imageRegistry` | String | The URL of the image registry where the replicated-sdk images are stored. | |
18 | | -| `image.registry` | String | The URL of the image registry where the replicated-sdk images are stored. | |
19 | | -| `image.repository` | String | The name of the replicated/replicated-sdk image repository. | |
20 | | -| `image.tag` | String | The tag of the replicated/replicated-sdk image. | |
21 | | -| `image.pullPolicy` | String | The Kubernetes image pull policy for the replicated/replicated-sdk image. | |
22 | | -| `license` | String | The yaml representation of the customer license. | |
23 | | -| `licenseFields` | string | The license fields of the customer. | |
24 | | -| `appName` | String | The name of the application, as specified in the Replicated Vendor Portal. | |
25 | | -| `channelID` | String | The unique ID of the release channel. | |
26 | | -| `channelName` | String | The name of the release channel (e.g., “Stable”, “Beta”). | |
27 | | -| `channelSequence` | Integer | The sequence number of the channel, sed to track updates in channel. | |
28 | | -| `releaseSequence` | Integer | The sequence number of the release associated with this deployment. | |
29 | | -| `releaseCreatedAt` | String | The timestamp when the release was created. | |
30 | | -| `releaseNotes` | String | Release notes for the current release, as provided in the Vendor Portal. | |
31 | | -| `versionLabel` | String | The version label for the release, often displayed in UI dashboards. | |
32 | | -| `parentChartURL` | String | The URL of the parent Helm chart if the application is nested in a chart hierarchy. | |
33 | | -| `statusInformers` | map | Configuration for custom status informers. Used for application health and status insights. | |
34 | | -| `replicatedAppEndpoint` | String | If it is not using the default Replicated App endpoint https://replicated.app, this field specifies the endpoint to use. | |
35 | | -| `serviceAccountName` | String | The name of the Kubernetes service account used by the Replicated SDK. | |
36 | | -| `clusterRole` | String | The name of the Kubernetes cluster role used by the Replicated SDK. | |
37 | | -| `imagePullSecrets` | Array | An array of Kubernetes image pull secrets that are used to pull images from private registries. | |
38 | | -| `nameOverride` | String | Overrides the name of the chart. | |
39 | | -| `namespaceOverride` | String | Overrides the namespace of the chart. | |
40 | | -| `containerSecurityContext.enabled` | Boolean | Enables the security context for the container. | |
41 | | -| `containerSecurityContext.runAsNonRoot`| Boolean | Runs the container as a non-root user. | |
42 | | -| `containerSecurityContext.readOnlyRootFilesystem` | Boolean | Mounts the container’s root filesystem as read-only. | |
43 | | -| `containerSecurityContext.allowPrivilegeEscalation` | Boolean | Allows privilege escalation for the container. | |
44 | | -| `containerSecurityContext.capabilities.drop` | Array | Define which capabilities for dropping. | |
45 | | -| `podSecurityContext.enabled` | Boolean | Enables the security context for the pod. | |
46 | | -| `podSecurityContext.runAsUser` | Integer | The user ID for the pod. | |
47 | | -| `podSecurityContext.runAsGroup` | Integer | The group ID for the pod. | |
48 | | -| `podSecurityContext.fsGroup` | Integer | The group ID for the pod’s filesystem. | |
49 | | -| `podSecurityContext.supplementalGroups` | Array | The supplemental groups for the pod. | |
50 | | -| `podSecurityContext.seccompProfile.type` | String | The type of seccomp profile. | |
51 | | -| `service.type` | String | The replicated-sdk service type. | |
52 | | -| `service.port` | Integer | The port for the replicated-sdk service. | |
53 | | -| `privateCAConfigmap` | String | The name of the ConfigMap that contains the private CA certificate. | |
54 | | -| `privateCASecret` | String | The name of the Secret that contains the private CA certificate. | |
55 | | -| `extraEnv` | Array | Additional environment variables to inject into the container. | |
56 | | -| `integration.licenseID` | String | The license ID of the customer. | |
57 | | -| `integration.enabled` | Boolean | Enables the integration. | |
58 | | -| `integration.mockData` | string | The mock data for the integration. | |
59 | | -| `isAirgap` | Boolean | Indicates whether the replicated is installed in airgap environment. | |
60 | | -| `replicatedID` | String | The unique ID of the replicated-sdk instance cluster ID. | |
61 | | -| `appID` | String | The unique ID of the replicated app slug. | |
62 | | -| `tolerations` | Array | The tolerations for the pod. | |
63 | | -| `affinity` | Object | The affinity for the pod. | |
| 17 | +| `enabled` | Boolean | Whether the Replicated SDK is enabled | |
| 18 | +| `appName` | String | The name of the application | |
| 19 | +| `channelID` | String | The unique ID of the release channel | |
| 20 | +| `channelName` | String | The name of the release channel (e.g., "Stable", "Beta") | |
| 21 | +| `channelSequence` | Integer | The sequence number of the channel | |
| 22 | +| `integration.enabled` | Boolean | Whether integration features are enabled | |
| 23 | +| `license` | String | The YAML representation of the customer license | |
| 24 | +| `parentChartURL` | String | The URL of the parent Helm chart | |
| 25 | +| `releaseCreatedAt` | String | The timestamp when the release was created | |
| 26 | +| `releaseNotes` | String | Release notes for the current release | |
| 27 | +| `releaseSequence` | Integer | The sequence number of the release | |
| 28 | +| `replicatedAppEndpoint` | String | The Replicated app endpoint URL | |
| 29 | +| `versionLabel` | String | The version label for the release | |
| 30 | + |
| 31 | +The `global.replicated` values schema contains the following fields: |
| 32 | + |
| 33 | +| Field | Type | Description | |
| 34 | +| --- | --- | --- | |
| 35 | +| `channelName` | String | The name of the release channel | |
| 36 | +| `customerEmail` | String | The email address of the customer | |
| 37 | +| `customerName` | String | The name of the customer | |
| 38 | +| `dockerconfigjson` | String | Base64 encoded docker config json for pulling images | |
| 39 | +| `licenseFields.expires_at.description` | String | Description of the license expiration | |
| 40 | +| `licenseFields.expires_at.signature` | Object | Signature data for the expiration field | |
| 41 | +| `licenseFields.expires_at.title` | String | Title of the expiration field | |
| 42 | +| `licenseFields.expires_at.value` | String | Value of the expiration field | |
| 43 | +| `licenseFields.expires_at.valueType` | String | Type of the expiration value | |
| 44 | +| `licenseFields.expires_at.signature.v1` | String | Signature data for the license | |
| 45 | +| `licenseID` | String | The unique identifier for the license | |
| 46 | +| `licenseType` | String | The type of license (e.g., "dev", "prod") | |
64 | 47 |
|
65 | 48 | ## license Values Schema |
66 | 49 |
|
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: |
| 50 | +The `license` field in the `global.replicated` values schema is a string that contains the YAML representation of the customer license: |
68 | 51 |
|
69 | 52 | ```yaml |
70 | 53 | apiVersion: kots.io/v1beta1 |
@@ -102,10 +85,4 @@ spec: |
102 | 85 | licenseType: A string value that describes the type of the license |
103 | 86 | replicatedProxyDomain: proxy.replicated.com |
104 | 87 | 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. |
109 | | - replicatedAppEndpoint: https://replicated.app |
110 | | - versionLabel: The version label for the release |
111 | 88 | ``` |
0 commit comments