Команды

Чарт - предварительно настроенный шаблон ресурсов
Релиз - чарт, развернутый с помощью Helm в k8s

• create - создает новый чарт с указанным именем
• package - упаковать каталог чарта в архив
• show - показать информацию о чарте
• get - расширенная информация о релизе
• verify - верификация чарта
• search - поиск в чарте

• pull - загрузить чарт из репы
• repo - работа с репами

• install - установить чарт
• upgrade - обновить релиз
• list - список релизов
• status - статус релиза
• rollback - откат релиза на предыдущую версию
• history - история релизов
• test - запустить тесты релиза
• uninstall - деинсталлировать релиз

• completion - создает сценарий автозаполнения
• dependency - управление зависимостями
• env - информация о среде
• lint - проверить чарт на возможные проблемы
• plugin - работа с плагинами
• template - локальное отображение шаблонов (?)
• version -

helm install <release name> <chart name>
 
# Тест итогового манифеста
helm install --dry-run test-release ./helm-chart
 
# Переопределение параметров при запуске (можно указать файлом)
helm install -n kubectl-ns --set certificateSecretStore.enabled=false my-app ./helm-chart
helm install -n kubectl-ns -f ./my-app-values.yaml my-app ./helm-chart 
 

Шаблонизация

# Просто переменная
metadata:
  name: {{ .Release.Name }}-certificate-secret-store
 
---
# Вставляем шаблон "helm-chart.labels" и передаем вывод через шаблонную ф-ю "nident"
# в данном случае она добавляет пробелы (4шт)
metadata:
  labels:
    {{- include "helm-chart.labels" . | nindent 4 }}
 
---
#

Есть ф-я «toYaml», пока неясно как но видимо в чем то помогает

spec:
  ...
  template:
    ...
    spec:
      containers:
      - name: {{ .Release.Name }}-app
		image: {{ .Values.deployment.image }}
		ports:
		- name: {{ .Values.clusterip.targetPort }}
		  containerPort: {{ .Values.deployment.containerPort }}
		resources:
          {{- toYaml .Values.deployment.resources | nindent 10 }}
	    {{- if .Values.lockboxSecretStore.enabled }}
        env:
        {{- range .Values.lockboxSecretStore.externalSecret.data }}
        - name: {{ .secretKey }}
          valueFrom:
            secretKeyRef:
              name: {{ $.Release.Name }}-lockbox-secret
              key: {{ .secretKey }}
        {{- end }}
        {{- end }}

values.yaml в данном случае такой

clusterip:
  port: 80
  targetPort: http

deployment:
  replicaCount: 1
  image: ""
  containerPort: 8080
  
  resources:
    requests:
      cpu: "150m"
      memory: "400Mi"
    limits:
      cpu: "250m"
      memory: "600Mi"

IF

Включение/Отключение частей кода с помощью переменных
Объявляем нужные переменные в «values.yaml», значение по умолчанию «true»

lockboxSecretStore:
  enabled: true

certificateSecretStore:
  enabled: true

Затем в манифесте проверка переменных, ветвление

{{- if .Values.certificateSecretStore.enabled -}}
apiVersion: external-secrets.io/v1beta1
kind: SecretStore
...
{{- end }}

При запуске, переменную можно переопределить

helm install --dry-run --set certificateSecretStore.enabled=false test-release ./helm-chart

FOR

Для циклов используется оператор «range»

lockboxSecretStore:
  enabled: true
  externalSecret:
    secretId: ""
    data:
    - secretKey: JDBC_URL
      property: JDBC_URL
    - secretKey: DB_USERNAME
      property: DB_USERNAME
    - secretKey: DB_PASSWORD
      property: DB_PASSWORD

spec:
  ...
    data:
   {{- range .Values.lockboxSecretStore.externalSecret.data }}
    - secretKey: {{ .secretKey }}
      remoteRef:
        key: {{ $.Values.lockboxSecretStore.externalSecret.secretId }}
        property: {{ .property }}
  {{- end }}

Знак $ - операторы «range» и «with» создают свою область видимости (точка указывает на текущую область). Чтобы получить значения из «values.yaml» нужно задать корневую область видимости, что и делает этот параметр