Опциональные действия перед обновлением системы

Перед запуском обновления системы вы можете выполнить следующие действия:

Смена доменного имени системы

При необходимости перед началом обновления вы можете изменить доменное имя, по которому доступен веб-интерфейс системы. Для этого:

  1. Подключитесь к терминалу master-узла кластера Kubernetes, в котором установлен основной экземпляр системы.

  2. Обновите доменное имя в секрете evo.infra.global, выполнив следующую команду:

    kubectl patch secret evo.infra.global -n <namespace> -p='{"stringData":{"FRONTEND_HOST": "<new_domain_name>","GRAFANA_EXTERNAL_URL": "https://<new_domain_name>/grafana"}}'

    Здесь:

    • <namespace> — название пространства имен, в котором установлена система.

    • <new_domain_name> — новое доменное имя, например, evo-new.company.local.

    В результате успешного обновления секрета должно отобразиться следующее сообщение:

    secret/evo.infra.global patched

После обновления система будет доступна по новому доменному имени.

Настройка защищенного соединения между узлами кластера

При необходимости вы можете настроить защищенное соединение между узлами кластера. Настройка осуществляется непосредственно перед обновлением системы, поскольку после включения защиты рекомендуется перезапуск всех подов кластера.

Чтобы настроить защищенное соединение между узлами кластера, вы можете включить использование протокола WireGuard для сетевого плагина Calico. После этого плагин начнет создавать защищенные туннели между узлами кластера.

  • Для работы WireGuard требуется ядро Linux версии 5.6 и выше, поскольку этот протокол встроен в ядро начиная с версии 5.6.

  • Трафик между узлами кластера будет защищен, но на каждом узле трафик между самим подом и его хостом останется открытым. Считается, что для его перехвата злоумышленнику требуется прямой доступ к самому хосту.

  • Трафик между подами на одном узле не будет защищен.

Инструкции по устранению типичных проблем при работе WireGuard приведены в разделе Устранение проблем при эксплуатации системы.

Включение защиты соединения

Чтобы включить защищенное соединение между узлами кластера, выполните следующие действия:

  1. Убедитесь что на всех узлах кластера открыт порт 51820.

  2. Подключитесь к терминалу master-узла кластера.

  3. Чтобы отслеживать статус WireGuard, установите утилиту wg с помощью менеджера пакетов вашей операционной системы, например:

    sudo dnf install -y yq wireguard-tools
  4. Включите параметр wireguardEnabled в ресурсе FelixConfiguration, выполнив следующую команду:

    kubectl patch felixconfiguration default --type='merge' -p '{"spec":{"wireguardEnabled":true}}'
  5. Убедитесь, что защищенное соединение между узлами кластера включено:

    1. Проверьте, что в информации об узлах Calico появилось поле wireguardPublicKey:

      for node in $(kubectl get nodes -o yaml| yq '.items[].metadata.name'); do
        echo ">>> $node";
        calicoctl get node $node -o yaml | grep wireguardPublicKey;
      done
    2. Проверьте, что утилита wg возвращает информацию о конфигурации, с помощью следующих команд:

      sudo wg show
      sudo wg showconf wireguard.cali

Рекомендации после включения защиты

Защита соединения с помощью WireGuard добавляет к каждому отправляемому пакету заголовок объемом 60 байт. Чтобы избежать фрагментации и потери пакетов, Calico автоматически корректирует максимальный размер передаваемых пакетов (MTU, Maximum Transmission Unit) для туннельных интерфейсов и всех новых подов.

Однако для уже существующих подов настройки MTU остаются прежними. В связи с этим после включения защиты рекомендуется выполнить следующие действия:

  1. Подключитесь к терминалу master-узла кластера.

  2. Перезапустите все поды в пространстве имен, в котором установлена система, а также в пространстве имен kube-prometheus-stack, используя следующую команду:

    kubectl rollout restart deployment -n <namespace>

    Здесь:

    • <namespace> — пространство имен.

    После перезапуска для подов будут обновлены настройки MTU.

Обновление ключей WireGuard

В Calico процесс обновления ключей WireGuard полностью автоматизирован и не требует ручных действий. Он встроен в работу компонента Felix на каждом узле кластера.

Обновление ключей выполняется следующим образом:

  1. Генерация новой пары ключей: компонент Felix периодически генерирует новую локальную пару ключей WireGuard (приватный и публичный ключи) на каждом узле кластера. Частота этой ротации не документирована как настраиваемый параметр и определяется внутренней логикой Calico.

  2. Размещение публичного ключа: после генерации нового ключа Felix автоматически обновляет статус своего узла (node resource) в Kubernetes API, сохраняя в аннотации или поле .status свой новый публичный ключ WireGuard.

  3. Обнаружение и применение: Felix постоянно отслеживает изменения в статусах всех узлов. Когда он обнаруживает, что у соседнего узла появился новый публичный ключ, он немедленно обновляет конфигурацию своего локального WireGuard-интерфейса (wireguard.cali), добавляя или заменяя ключ для соответствующего пира (peer).

Таким образом процесс смены ключей происходит без разрыва существующих соединений, так как WireGuard поддерживает несколько ключей одновременно в течение короткого переходного периода.

Была ли полезна эта страница?

Обратная связь