Skip to content

Commit cda1da2

Browse files
committed
update
1 parent c1c55ee commit cda1da2

File tree

2 files changed

+43
-34
lines changed

2 files changed

+43
-34
lines changed

docs/vendor/helm-image-registry.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ To enable the proxy registry:
5050
```yaml
5151
# values.yaml
5252
...
53+
dockerconfigjson: '{{ .Values.global.replicated.dockerconfigjson }}'
5354
images:
5455
myapp:
5556
# Add image URL in the values file

docs/vendor/replicated-sdk-values-schema.md

Lines changed: 42 additions & 34 deletions
Original file line numberDiff line numberDiff 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-
51
# Helm global.replicated Values Schema
62

73
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
2319
| `image.repository` | String | The name of the replicated/replicated-sdk image repository. |
2420
| `image.tag` | String | The tag of the replicated/replicated-sdk image. |
2521
| `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. |
2723
| `licenseFields` | string | The license fields of the customer. |
2824
| `appName` | String | The name of the application, as specified in the Replicated Vendor Portal. |
2925
| `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
6662
| `tolerations` | Array | The tolerations for the pod. |
6763
| `affinity` | Object | The affinity for the pod. |
6864

65+
## license Values Schema
6966

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:
7568

7669
```yaml
77-
dockerconfigjson: '{{ .Values.global.replicated.dockerconfigjson }}'
78-
images:
79-
myapp:
80-
# Add image URL in the values file
81-
apiImageRepository: proxy.replicated.com/proxy/my-app/quay.io/my-org/api
82-
apiImageTag: v1.0.1
83-
```
84-
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
9072
metadata:
91-
name: example
73+
name: name of the license
9274
spec:
93-
template:
94-
spec:
95-
containers:
96-
- name: api
97-
# Access the apiImageRepository field from the values file
98-
image: "{{ .Values.images.myapp.apiImageRepository }}:{{ .Values.images.myapp.apiImageTag }}"
99-
{{ 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.
109+
replicatedAppEndpoint: https://replicated.app
110+
versionLabel: Unstable-1457889-dirty
103111
```

0 commit comments

Comments
 (0)