Что такое ConfigMap в Kubernetes?

Что такое ConfigMap в Kubernetes?

ConfigMap — это объект Kubernetes API первого уровня, предназначенный для хранения конфигурационных данных в виде пар "ключ-значение" или конфигурационных файлов. Основная цель ConfigMap — отделить конфигурацию приложения от его образа контейнера, что позволяет изменять настройки без пересборки или переразвертывания образа, следуя принципам Twelve-Factor App.

Ключевые характеристики и назначение

• Хранение неконфиденциальных данных: ConfigMap предназначен для обычных конфигурационных данных (например, флаги, настройки, файлы конфигурации). Для секретов (пароли, токены) используется объект Secret.
• Гибкие форматы данных:

    *   Отдельные ключ-значение.
    *   Целые файлы конфигурации (например, `nginx.conf`, `application.properties`).
    *   Переменные среды (environment variables).

• Декларативное управление: ConfigMap можно создать из файла YAML/JSON, командой kubectl или из директории с файлами.
• Динамическое обновление: ConfigMap можно обновлять после создания. Однако механизм уведомления пода об изменениях зависит от способа его использования внутри пода.

Способы использования ConfigMap в Pod'ах

ConfigMap сам по себе просто хранит данные. Чтобы использовать их в поде, необходимо явно сослаться на ConfigMap в спецификации Pod (или Deployment, StatefulSet и т.д.). Основные способы:

1. В качестве переменных среды (Environment Variables):

    Весь ConfigMap или отдельные его ключи можно передать в контейнер в виде переменных окружения.

```yaml
apiVersion: v1
kind: Pod
metadata:
  name: example-pod
spec:
  containers:
  - name: app
    image: myapp:latest
    env:
      # Определяем переменную из ключа ConfigMap
      - name: LOG_LEVEL
        valueFrom:
          configMapKeyRef:
            name: app-config   # Имя ConfigMap
            key: log_level     # Конкретный ключ в ConfigMap
```

2. В качестве файлов в Volume (томе):

    ConfigMap можно смонтировать в Pod как том. Kubernetes создаст файлы в указанной директории, где имя файла будет соответствовать ключу ConfigMap, а содержимое — его значению. Это наиболее удобный способ для передачи конфигурационных файлов целиком.

```yaml
apiVersion: v1
kind: Pod
metadata:
  name: nginx-pod
spec:
  containers:
  - name: nginx
    image: nginx:alpine
    volumeMounts:
    - name: config-volume
      mountPath: /etc/nginx/conf.d  # Директория для монтирования
  volumes:
  - name: config-volume
    configMap:
      name: nginx-config           # Имя смонтируемого ConfigMap
```

3. Аргументы командной строки: Значения из ConfigMap можно использовать для заполнения аргументов командной строки (args) контейнера.

Практический пример создания и использования

Создадим ConfigMap из файла и смонтируем его в Pod.

1. Создаем файл конфигурации app.properties:

   cache.size=1024
   app.name=MyMicroservice
   

2. Создаем ConfigMap kubectl create configmap app-config --from-file=app.properties. Или декларативно через манифест:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config
   data:
     app.properties: |
       cache.size=1024
       app.name=MyMicroservice
   

3. Используем его в Pod через Volume:

   apiVersion: v1
   kind: Pod
   metadata:
     name: myapp-pod
   spec:
     containers:
     - name: app-container
       image: myapp:latest
       volumeMounts:
       - name: config-volume
         mountPath: /config
     volumes:
     - name: config-volume
       configMap:
         name: app-config
   

    После запуска пода файл `/config/app.properties` внутри контейнера будет содержать наши настройки.

Важные ограничения и best practices

• Обновление данных: При изменении ConfigMap данные в уже запущенных подах обновляются не мгновенно и не всегда автоматически. Для переменных среды обновления не применяются вообще. Для томов (Volumes) обновление происходит с задержкой (порядка минуты). Существуют sidecar-решения (например, Reloader) для автоматического перезапуска пода при изменении ConfigMap.
• Размер данных: ConfigMap не предназначен для хранения больших данных (ограничение в 1 MiB на объект в etcd).
• Именование: Имя ConfigMap должно быть уникальным в пределах пространства имен (namespace).
• Идемпотентность: Приложения должны быть спроектированы так, чтобы можно было безопасно перечитать конфигурацию "на лету" или перезапуститься без потери данных.

Итог: ConfigMap — это фундаментальный и мощный механизм в Kubernetes для управления конфигурацией, который обеспечивает гибкость, безопасность и соответствие современным DevOps-практикам. Он позволяет централизованно управлять настройками множества приложений, упрощает процесс deployment и способствует поддержанию immutable-инфраструктуры.