Развертывание кластера в Amazon Elastic Kubernetes Service

Перед развертыванием ArcGIS Enterprise on Kubernetes в Amazon Web Services (AWS) необходимо подготовить кластер Amazon Elastic Kubernetes Service (EKS), который соответствует системным требованиям ArcGIS Enterprise.

Подготовка кластера EKS включает шаги, общие для поддерживаемых сред, такие как настройка кластера Kubernetes и соответствующих узлов, а также шаги, специфичные для среды, такие как настройка ролей AWS Identity and Access Management (IAM).

Внимательно ознакомьтесь со следующими шагами и обратитесь к документации AWS для получения более подробных инструкций о том, как подготовить вашу среду. Инструкции по развертыванию ArcGIS Enterprise на кластере EKS с использованием Karpenter автомасштабирования кластера см. в руководстве по развертыванию EKS Auto Mode.

1. Создайте Amazon Virtual Private Cloud (VPC).

   Необходимо создать VPC, которая соответствует как требованиям Amazon EKS, так и требованиям к масштабируемости ArcGIS Enterprise on Kubernetes.

   Большое развертывание Kubernetes может потреблять тысячи IP-адресов. После создания кластера диапазоны Classless Inter-Domain Routing (CIDR) VPC и связанных подсетей не могут быть изменены.

   Количество необходимых IP-адресов во многом зависит от количества рабочих нагрузок в кластере, но тестирование на масштабируемость показало, что каждая подсеть должна быть настроена с минимальной маской подсети /18. Это позволяет получить более 16000 доступных IP-адресов на подсеть.

2. Дополнительно включите шифрование конверта для секретных данных и создайте ключ для Key Management Service (KMS).

   Рекомендуется включить шифрование конвертов для секретов, хранящихся в etcd для кластера EKS. Для этого в Amazon EKS должен присутствовать симметричный ключ шифрования.

   Примечание:

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

3. Создайте кластер EKS.

   При создании кластера EKS вы будете ссылаться на VPC, подсети, роль IAM и ключ KMS, созданные на предыдущих шагах. ArcGIS Enterprise on Kubernetes не поддерживается в AWS Fargate, так как базовые узлы не подлежат настройке.

   Версия Kubernetes кластера должна соответствовать тому, что указано в Системных требованиях.

4. Создайте роль группы узлов IAM.

   После создания кластера группы вы должны создать группу рабочих узлов. Создание группы узлов требует дополнительной роли IAM, которая определяет сервисы AWS, к которым могут обращаться связанные экземпляры EC2.

5. Создайте группу узлов.

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

6. Обновите конфигурацию kubectl.

   После создания кластера интерфейс командной строки (CLI) AWS можно использовать для извлечения информации о подключении cluster-admin в ваш файл kubeconfig. Воспользуйтесь следующей командой:

   aws eks update-kubeconfig -name <CLUSTER_NAME> --region <REGION>

7. Создайте роль кластера IAM.

   Для кластера Amazon EKS требуется роль IAM, определяющая ресурсы, к которым кластер может получать доступ. ArcGIS Enterprise on Kubernetes не имеет никаких требований, выходящих за рамки того, что описано AWS.

8. Создайте поставщика аутентификации OpenID Connect (OIDC).

   Для взаимодействия с другими сервисами AWS изнутри кластера AWS рекомендует использовать провайдер OIDC. Этот провайдер объединяет кластер Kubernetes с организацией AWS для сопоставления доступа учетных записей сервисов Kubernetes к ресурсам AWS. Что касается ArcGIS Enterprise on Kubernetes, это рекомендуется для обеспечения работы AWS Load Balancer Controller и драйвера Amazon Elastic Block Store (EBS) Container Storage Interface (CSI). Эти два дополнения снижают административные усилия, необходимые для развертывания ArcGIS Enterprise on Kubernetes.

9. Установите Надстройку контроллера балансировщика нагрузки.

   В EKS администратор может направлять трафик в кластер многими способами. Чтобы использовать балансировщик нагрузки, администратор должен установить Контроллер балансировщика нагрузки. AWS Load Balancer Controller управляет эластичными балансировщиками нагрузки AWS для кластера Kubernetes.

   В процессе развертывания администратор может подготовить балансировщик нагрузки из скрипта развертывания. При запуске скрипта Контроллер балансировщика нагрузки создает балансировщик нагрузки сети (внутренний или внешний), целевую группу, группы безопасности и другие параметры для управления маршрутизацией к рабочим узлам.

   Или, администратор может использовать входной контроллер уровня кластера для маршрутизации трафика, что требует дополнительных шагов. Когда администратор использует входной контроллер уровня кластера, скрипт не подготавливает Балансировщик нагрузки приложения (ALB). См. дополнительные шаги, чтобы использовать балансировки нагрузки приложения на EKS. При использовании входящего контроллера уровня кластера, Контроллер балансировщика нагрузки создает ALB, целевую группу, группы безопасности и другие параметры для управления маршрутизацией к рабочим узлам.

10. Установите Надстройку драйвера Amazon EBS CSI.

    Драйвер Amazon EBS CSI является требованием Amazon EKS версии 1.23 и выше, которое позволяет динамически подготавливать тома EBS с использованием Persistent Volumes Claims (PVC) в кластере. Первый шаг — создание роли IAM и учетной записи сервиса Kubernetes для драйвера CSI. Второй этап - развертывание рабочих нагрузок драйвера CSI на кластере.

    Чтобы воспользоваться последним классом томов EBS, рекомендуется создать класс хранения, ссылающийся на тип gp3. Примените соответствующий файл .yaml к кластеру с помощью следующей команды:

    kubectl apply -f <storageClass.yaml>

    См. образец файла класса хранения по умолчанию .yaml файл и образец файла резервного класса хранения .yaml файл для получения дополнительной информации.

После создания пространства имен в кластере Kubernetes вы можете настроить и развернуть кластер EKS в ArcGIS Enterprise. При развертывании настройте ArcGIS Enterprise на создание балансировщика нагрузки. Когда вы настраиваете свою организацию, ссылайтесь на созданный вами класс хранилища.