Newer
Older
![Yevhenii Orlov (EPAM) [GCP]'s avatar](https://secure.gravatar.com/avatar/1c57ec26c9ed706abfd3994759f0b42d5b0711e2f79e3f70565a1c80e4d96351?s=144&d=identicon "Yevhenii Orlov (EPAM) [GCP]")
<!--- Deploy -->
# Deploy helm chart
## Introduction
This chart bootstraps a deployment on a [Kubernetes](https://kubernetes.io) cluster using [Helm](https://helm.sh) package manager.
## Prerequisites
The code was tested on **Kubernetes cluster** (v1.21.11) with **Istio** (1.12.6)
> It is possible to use other versions, but it hasn't been tested
### Operation system
The code works in Debian-based Linux (Debian 10 and Ubuntu 20.04) and Windows WSL 2. Also, it works but is not guaranteed in Google Cloud Shell. All other operating systems, including macOS, are not verified and supported.
### Packages
Packages are only needed for installation from a local computer.
- **HELM** (version: v3.7.1 or higher) [helm](https://helm.sh/docs/intro/install/)
- **Kubectl** (version: v1.21.0 or higher) [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
## Installation
First you need to set variables in **values.yaml** file using any code editor. Some of the values are prefilled, but you need to specify some values as well. You can find more information about them below.
### Global variables
![Ihor Anikeiev [EPAM / GCP]'s avatar](https://secure.gravatar.com/avatar/f03224d3a2e98b4526c4b5597f973fb96f98f80d98de7a2ba886c386166d96a7?s=144&d=identicon "Ihor Anikeiev [EPAM / GCP]")
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|--------------------------|---------------------------------------------------------|---------|---------|----------|
| **global.domain** | your domain for the external endpoint, ex `example.com` | string | - | yes |
| **global.limitsEnabled** | whether CPU and memory limits are enabled | boolean | `true` | yes |
| **global.logLevel** | severity of logging level | string | `ERROR` | yes |
| **global.tier** | Only PROD must be used to enable autoscaling | string | - | no |
| **global.autoscaling** | enables horizontal pod autoscaling, when tier=PROD | boolean | `true` | yes |
![Volodymyr Pienskoi [EPAM / GCP]'s avatar](https://secure.gravatar.com/avatar/26179c5afd889ed6def0ac252e50bc3ab83894e443bc6bd1e7c284e7a9422416?s=144&d=identicon "Volodymyr Pienskoi [EPAM / GCP]")
### Configmap variables
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|-------------------------------------|----------------------------------------------------------------------------------------------|--------|-------------------------|-------------------------------------------------|
| **data.logLevel** | logging severity level for this service only | string | - | yes, only if differs from the `global.logLevel` |
| **data.defaultDataCountry** | Data storage region | string | `US` | yes |
| **data.storageServiceAccountEmail** | Storage service account email, used during OQM events processing | string | `storage@service.local` | yes |
| **data.entitlementsHost** | Entitlements service host address | string | `http://entitlements` | yes |
| **data.partitionHost** | Partition service host address | string | `http://partition` | yes |
| **data.crsConverterHost** | CRS Converter service host address | string | `http://crs-conversion` | yes |
| **data.legalHost** | Legal service host address | string | `http://legal` | yes |
| **data.opaEndpoint** | OPA host address | string | `http://opa` | yes |
| **data.redisStorageHost** | The host for redis instance. If empty (by default), helm installs an internal redis instance | string | - | yes |
| **data.redisStoragePort** | The port for redis instance | digit | `6379` | yes |
### Deployment variables
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|-----------------------------|------------------------------------|--------|----------------|----------------------------------------|
| **data.requestsCpu** | amount of requested CPU | string | `10m` | yes |
| **data.requestsMemory** | amount of requested memory | string | `650Mi` | yes |
| **data.limitsCpu** | CPU limit | string | `1` | only if `global.limitsEnabled` is true |
| **data.limitsMemory** | memory limit | string | `3G` | only if `global.limitsEnabled` is true |
| **data.image** | path to the image in a registry | string | - | yes |
| **data.imagePullPolicy** | when to pull the image | string | `IfNotPresent` | yes |
| **data.serviceAccountName** | name of kubernetes service account | string | `storage` | yes |
| **data.redisImage** | service image | string | `redis:7` | yes |
### Configuration variables
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|---------------------------------|-----------------------------------------------------------------------|---------|------------------------|----------|
| **conf.appName** | Service name | string | `storage` | yes |
| **conf.storageRedisSecretName** | secret for redis that contains redis password with REDIS_PASSWORD key | string | `storage-redis-secret` | yes |
| **conf.replicas** | Number of replicas | integer | `3` | yes |
### Istio variables
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|----------------------------|-----------------------------------|--------|---------|----------|
| **istio.proxyCPU** | CPU request for Envoy sidecars | string | `10m` | yes |
| **istio.proxyCPULimit** | CPU limit for Envoy sidecars | string | `200m` | yes |
| **istio.proxyMemory** | memory request for Envoy sidecars | string | `100Mi` | yes |
| **istio.proxyMemoryLimit** | memory limit for Envoy sidecars | string | `256Mi` | yes |
![Vadzim Beuzo [EPAM / GCP]'s avatar](https://secure.gravatar.com/avatar/52432dfe61c8591360a34b1c31961b7d39d1c594ad030ed1911ede4168eeaae3?s=144&d=identicon "Vadzim Beuzo [EPAM / GCP]")
### Horizontal Pod Autoscaling (HPA) variables (works only if tier=PROD and autoscaling=true)
| Name | Description | Type | Default | Required |
|-----------------------------------------------------|-------------------------------------------------------------------------------|---------|------------------|----------------------------------------------------------------|
| **hpa.minReplicas** | minimum number of replicas | integer | `6` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.maxReplicas** | maximum number of replicas | integer | `20` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.targetType** | type of measurements: AverageValue or Value | string | `"AverageValue"` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.targetValue** | threshold value to trigger the scaling up | integer | `45` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleUpStabilizationWindowSeconds** | time to start implementing the scale up when it is triggered | integer | `10` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleUpPoliciesValue** | the maximum number of new replicas to create (in percents from current state) | integer | `50` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleUpPoliciesPeriodSeconds** | pause for every new scale up decision | integer | `15` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleDownStabilizationWindowSeconds** | time to start implementing the scale down when it is triggered | integer | `60` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleDownPoliciesValue** | the maximum number of replicas to destroy (in percents from current state) | integer | `25` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **hpa.behaviorScaleDownPoliciesPeriodSeconds** | pause for every new scale down decision | integer | `60` | only if `global.autoscaling` is true and `global.tier` is PROD |
### Limits variables
Ihor Anikeiev [EPAM / GCP]
committed
| Name | Description | Type | Default | Required |
|--------------------------|-------------------------------------------------|---------|--------|----------------------------------------------------------------|
| **limits.maxTokens** | maximum number of requests per fillInterval | integer | `30` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **limits.tokensPerFill** | number of new tokens allowed every fillInterval | integer | `30` | only if `global.autoscaling` is true and `global.tier` is PROD |
| **limits.fillInterval** | time interval | string | `"1s"` | only if `global.autoscaling` is true and `global.tier` is PROD |
### Methodology for Parameter Calculation variables: **hpa.targetValue**, **limits.maxTokens** and **limits.tokensPerFill**
The parameters **hpa.targetValue**, **limits.maxTokens** and **limits.tokensPerFill** were determined through empirical testing during load testing. These tests were conducted using the N2D machine series, which can run on either AMD EPYC Milan or AMD EPYC Rome processors. The values were fine-tuned to ensure optimal performance under typical workloads.
### Recommendations for New Instance Types
When changing the instance type to a newer generation, such as the C3D series, it is essential to conduct new load testing. This ensures the parameters are recalibrated to match the performance characteristics of the new processor architecture, optimizing resource utilization and maintaining application stability.
## Install the Helm chart
Run this command from within this directory:
```console
## Uninstall the Helm chart
To uninstall the helm deployment:
```console
> Do not forget to delete all k8s secrets and PVCs accociated with the Service.
[Move-to-Top](#deploy-helm-chart)