Создание StatefulSet

• При удалении или масштабировании StatefulSet система не удаляет тома хранилища, связанные с StatefulSet, чтобы обеспечить безопасность данных.
• При удалении StatefulSet уменьшите количество реплик до 0 перед удалением StatefulSet, чтобы pod в StatefulSet могли быть остановлены последовательно.
• При создании StatefulSet требуется headless Service для доступа к pod. Подробнее см. Headless Services.
• Когда узел недоступен, pod переходят в состояние Unready. В этом случае вручную удалите pod StatefulSet, чтобы pod могли быть перенесены на обычный узел.

• Кластер доступен. Подробнее о том, как создать кластер, см. Buying a Standard/Turbo Cluster.
• В кластере есть доступные узлы. Если узел недоступен, создайте его, обратившись к Creating a Node.

1. Войдите в CCE console.
2. Нажмите название кластера, чтобы перейти в консоль кластера, выберите Workloads в панели навигации и нажмите Create Workload в правом верхнем углу.
3. Настройте basic information о workload.

   Параметр	Описание
   Workload Type	Выберите StatefulSet. Для получения подробной информации о различных типах рабочих нагрузок см. Workload Overview.
   Workload Name	Введите имя для workload. Введите от 1 до 63 символов, начинающихся со строчной буквы и заканчивающихся строчной буквой или цифрой. Разрешены только строчные буквы, цифры и дефисы (-).
   Namespace	Выберите пространство имён для workload. Значение по умолчанию — default. Вы также можете нажать Create Namespace, чтобы создать его. Для получения подробной информации см. Creating a Namespace.
   Pods	Введите количество pods workload.
   Container Runtime	Стандартный кластер CCE использует общий runtime по умолчанию, тогда как кластер CCE Turbo поддерживает как общий, так и защищённый runtime. Для получения подробной информации об их различиях см. Secure Runtime and Common Runtime.
   Time Zone Synchronization	Настройте, включить ли синхронизацию часового пояса. После включения этой функции контейнер и узел будут использовать один и тот же часовой пояс. Синхронизация часового пояса опирается на локальный диск, смонтированный в контейнере. Не изменяйте и не удаляйте локальный диск. Подробнее см. Configuring Time Zone Synchronization.

4. Настройте container settings для рабочей нагрузки.
   • Container Information: нажмите Add Container справа, чтобы настроить несколько контейнеров для pod.
     Caution

     Если вы настроили несколько контейнеров для pod, убедитесь, что порты, используемые каждым контейнером, не конфликтуют друг с другом, иначе рабочая нагрузка не может быть развернута.

     • Basic Info: настройте базовую информацию о контейнере.

       Параметр	Описание
       Имя контейнера	Введите имя контейнера.
       Политика получения	Политика обновления или получения образа. Если выбрать Always, образ будет загружаться из репозитория образов каждый раз. Если не выбрать Always, предпочтительно будет использоваться существующий образ узла. Если образ отсутствует, он будет загружен из репозитория образов.
       Имя образа	Нажмите Select Image и выберите образ, используемый контейнером. To use a third-party image, directly enter image path. Ensure that the image access credential can be used to access the image repository. For details, see Using Third-Party Images.
       Тег образа	Выберите image tag для развертывания.
       CPU Quota	Request: минимальное количество ядер CPU, требуемое контейнером. Значение по умолчанию — 0.25 ядра. Limit: максимальное количество ядер CPU, которое может использовать контейнер. Это предотвращает чрезмерное использование ресурсов контейнерами. Если Request и Limit не указаны, квота не ограничивается. Для получения дополнительной информации и рекомендаций по Request и Limit см. Configuring Container Specifications.
       Memory Quota	Request: минимальный объём памяти, требуемый контейнером. Значение по умолчанию — 512 MiB. Limit: максимальный объём памяти, доступный контейнеру. При превышении использования памяти указанного предела контейнер будет завершён. Если Request и Limit не указаны, квота не ограничивается. Для получения дополнительной информации и рекомендаций по Request и Limit см. Configuring Container Specifications.
       (Optional) GPU Quota	Настраивается только при наличии в кластере узлов GPU и установленном дополнении CCE AI Suite (NVIDIA GPU). Do not use: GPU не будет использоваться. GPU card: GPU выделяется для контейнера. GPU Virtualization: процент ресурсов GPU, используемых контейнером. Например, если этот параметр установлен в 10%, контейнер будет использовать 10 % ресурсов GPU. Подробную информацию о том, как использовать GPU в кластере, см. Default GPU Scheduling in Kubernetes.
       (Optional) Privileged Container	Программы в привилегированном контейнере обладают определёнными привилегиями. Если эта опция включена, контейнеру будут назначены привилегии. Например, привилегированные контейнеры могут управлять сетевыми устройствами на хост‑машине, изменять параметры ядра, получать доступ ко всем устройствам узла. Для получения дополнительной информации см. Pod Security Standards.
       (Optional) Init Container	Определяет, использовать ли контейнер в качестве init‑контейнера. Init‑контейнер не поддерживает проверку состояния. Init‑контейнер — это специальный контейнер, который запускается до того, как будут запущены другие контейнеры приложений в pod. Каждый pod может содержать несколько контейнеров. Кроме того, pod может включать один или несколько init‑контейнеров. Контейнеры приложений в pod запускаются и работают только после завершения работы всех init‑контейнеров. Подробности см. в Init Containers.
       (Optional) Run Option	Add run options for the container. For details, see Pod. CCE supports the following run options: stdin: позволяет контейнерам получать ввод из внешних источников, например терминалов или других потоков ввода. tty: выделяет контейнерам псевдо‑терминал, позволяя отправлять им команды так, как если бы вы использовали локальный терминал. In most cases, tty is enabled along with stdin, indicating that the terminal (tty) is associated with the standard input (stdin) of the container. This allows for interactive operations, similar to the kubectl exec -i -t command. The difference is that this parameter has been configured when the pod is launched.

     • (Optional) Lifecycle: Configure operations to be performed in a specific phase of the container lifecycle, such as Startup Command, Post-Start, and Pre-Stop. For details, see Configuring the Container Lifecycle.
     • (Optional) Health Check: Set the liveness probe, ready probe, and startup probe as required. For details, see Configuring Container Health Check.
     • (Optional) Environment Variables: Configure variables for the container running environment using key-value pairs. These variables transfer external information to containers running in pods and can be flexibly modified after application deployment. For details, see Configuring Environment Variables.
     • (Optional) Data Storage: Mount local storage or cloud storage to the container. The application scenarios and mounting modes vary with the StorageClass. For details, see Storage.
       Note

       • StatefulSets поддерживают динамическое присоединение EVS дисков. Для получения подробной информации см. Dynamically Mounting an EVS Disk to a StatefulSet или Dynamically Mounting a Local PV to a StatefulSet.

         Динамическое монтирование достигается с помощью поля volumeClaimTemplates и зависит от возможности динамического создания StorageClass. StatefulSet связывает каждый pod с PVC, используя поле volumeClaimTemplates, а PVC привязывается к соответствующему PV. Поэтому после пересоздания pod оригинальные данные могут быть смонтированы на основе имени PVC.

       • После создания рабочей нагрузки динамически смонтированное хранилище нельзя обновлять.
     • (Optional) Security Context: Назначьте разрешения контейнера для защиты системы и других контейнеров от воздействия. Укажите идентификатор пользователя, чтобы назначить разрешения контейнера и предотвратить влияние на системы и другие контейнеры.
     • (Optional) Logging: По умолчанию отправляйте стандартные журналы вывода контейнера в AOM без необходимости ручных настроек. Вы можете вручную настроить путь сбора журналов. Для получения подробной информации см. Using ICAgent to Collect Container Logs.

       Чтобы отключить сбор журналов стандартного вывода текущей рабочей нагрузки, добавьте аннотацию kubernetes.AOM.log.stdout: [] в Labels and Annotations в области Advanced Settings. Для получения подробной информации о том, как использовать эту аннотацию, см. Table 1.

   • Image Access Credential: Выберите учетные данные, используемые для доступа к репозиторию образов. Значение по умолчанию — default-secret. Вы можете использовать default-secret для доступа к образам в SWR Shared Edition. Для получения подробной информации о default-secret см. default-secret.
   • (Optional) GPU: По умолчанию выбрано All. Инстанс рабочей нагрузки будет запланирован на узел указанного типа GPU.

5. Настройте settings of the headless Service, связанную с рабочей нагрузкой.

   Headless Service предоставляет фиксированное доменное имя доступа для каждого pod в StatefulSet для взаимного доступа pod‑ов. Для получения подробной информации см. Headless Services.

6. (Optional) Настройте the settings of the Service, связанную с рабочей нагрузкой.

   Service обеспечивает внешний доступ к pod‑ам. При статическом IP-адресе Service перенаправляет трафик доступа к pod‑ам и автоматически балансирует нагрузку для этих pod‑ов.

   Вы также можете создать Service после создания рабочей нагрузки. Для получения подробной информации о Service разных типов см. Service Overview.

7. (Optional) Configure advanced settings for the workload.

   Параметр	Description
   Upgrade	Укажите режим обновления и параметры рабочей нагрузки. Rolling upgrade и Replace upgrade доступны. Для получения подробной информации см. Upgrading and Rolling Back a Workload.
   Pod Management Policies	Для некоторых распределённых систем гарантии упорядочения StatefulSet не нужны и/или нежелательны. Такие системы требуют только уникальности и идентификаторов. OrderedReady: Это политика по умолчанию. StatefulSet будет развёртывать, удалять или масштабировать pods последовательно, по одному. Продолжение происходит только после того, как предыдущий pod будет готов или удалён. Parallel: StatefulSet будет создавать pods параллельно или удалять все pods одновременно. Изменения в StatefulSet применяются к pods немедленно.
   Scheduling	Настройте политики аффинности и анти‑аффинности для гибкого планирования рабочей нагрузки. Предоставляются политики Load affinity и Node affinity. Load Affinity: Предлагаются типовые политики Load affinity для быстрого развертывания Load affinity. Not configured: Политика Load affinity не настроена. Multi-AZ deployment preferred: pods рабочей нагрузки preferentially планируются на узлы в разных AZ через pod anti-affinity. Forcible multi-AZ deployment: pods рабочей нагрузки принудительно планируются на узлы в разных AZ через pod anti-affinity (podAntiAffinity). Если AZ меньше, чем pods, лишние pods не запустятся. Customize affinity: Политики аффинности и анти‑аффинности могут быть настроены. Для получения подробной информации см. Configuring Workload Affinity or Anti-affinity Scheduling (podAffinity or podAntiAffinity). Node Affinity: Предлагаются типовые политики Node affinity для быстрого развертывания Load affinity. Not configured: Политика привязки к узлам не настроена. Specify node: Подам рабочей нагрузки можно развернуть на указанных узлах с помощью привязки к узлам (nodeAffinity). Если узел не указан, поды будут распределяться случайным образом в соответствии с политикой планирования кластера по умолчанию. Specify node pool: Подам рабочей нагрузки можно развернуть в указанном пуле узлов с помощью привязки к узлам (nodeAffinity). Если пул узлов не указан, поды будут распределяться случайным образом в соответствии с политикой планирования кластера по умолчанию. Customize affinity: Политики привязки и антипривязки можно настроить. Подробнее см. Configuring Node Affinity Scheduling (nodeAffinity).
   Толерантность	Использование как taints, так и tolerations позволяет (не принудительно) планировать pod на узел с соответствующими taints и управлять политиками выселения pod после того, как узел, на котором находится pod, будет помечен taint. Подробнее см. Configuring Tolerance Policies.
   Метки и аннотации	Добавьте метки или аннотации для pod, используя пары ключ‑значение. После настройки нажмите Confirm. Подробнее о метках и аннотациях см. Configuring Labels and Annotations.
   DNS	Настройте отдельную политику DNS для рабочей нагрузки. Подробнее см. DNS Configuration.
   Конфигурация сети	Ограничение пропускной способности входящего/исходящего трафика Pod: Вы можете задать ограничения пропускной способности входящего и исходящего трафика для pod. Подробнее см. Configuring QoS for a Pod. Включить ли указанную конфигурацию сетевого контейнера: доступно только для кластеров, поддерживающих эту функцию. После включения указанной конфигурации сетевого контейнера рабочая нагрузка будет использовать подсеть и группу безопасности, определённые в конфигурации. Подробнее см. Binding a Subnet and Security Group to a Namespace or Workload Using a Container Network Configuration. Укажите имя конфигурации сетевого контейнера: можно выбрать только пользовательскую конфигурацию сетевого контейнера, тип связанного ресурса которой — рабочая нагрузка. Общая пропускная способность IPv6: доступно только для кластеров, поддерживающих эту функцию. После включения этой функции вы можете настроить общую пропускную способность для pod с сетевыми интерфейсами IPv6 dual‑stack. Подробнее см. Configuring a Shared Bandwidth for Dual-Stack Pods in a CCE Turbo Cluster.

8. нажмите Create Workload в правом нижнем углу. Через некоторое время workload переходит в состояние Running.

В этом примере используется workload Nginx, и том EVS динамически монтируется к нему с помощью поля volumeClaimTemplates.

1. Используйте kubectl для доступа к кластеру. Подробнее см. Accessing a Cluster Using kubectl.
2. Создайте и отредактируйте файл nginx-statefulset.yaml.

   nginx-statefulset.yaml — пример имени файла, и вы можете изменить его по необходимости.

   vi nginx-statefulset.yaml
   
   

   Ниже приведённый контент является лишь примером. Подробнее о StatefulSets см. в Kubernetes official documentation.

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: nginx
   spec:
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
           - name: container-1
             image: nginx:latest
             imagePullPolicy: IfNotPresent
             resources:
               requests:
                 cpu: 250m
                 memory: 512Mi
               limits:
                 cpu: 250m
                 memory: 512Mi
             volumeMounts:
               - name: test
                 readOnly: false
                 mountPath: /usr/share/nginx/html
                 subPath: ''
         imagePullSecrets:
           - name: default-secret
         dnsPolicy: ClusterFirst
         volumes: []
     serviceName: nginx-svc
     replicas: 2
     volumeClaimTemplates:  # Dynamically mounts the EVS volume to the workload.
       - apiVersion: v1
         kind: PersistentVolumeClaim
         metadata:
           name: test
           namespace: default
           annotations:
             everest.io/disk-volume-type: SAS  # SAS EVS volume type.
           labels:
             failure-domain.beta.kubernetes.io/region: ru-moscow-1  # region where the EVS volume is created.
             failure-domain.beta.kubernetes.io/zone: ru-moscow-1a   # AZ where the EVS volume is created. It must be the same as the AZ of the node.
         spec:
           accessModes:
             - ReadWriteOnce  # The value must be  ReadWriteOnce  for the EVS volume.
           resources:
             requests:
               storage: 10Gi
           storageClassName: csi-disk # StorageClass name. The value is  csi-disk  for the EVS volume.
     updateStrategy:
       type: RollingUpdate
   
   

   Создайте файл nginx-headless.yaml.

   vi nginx-headless.yaml
   
   

   Содержимое файла:

   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-svc
     namespace: default
     labels:
       app: nginx
   spec:
     selector:
       app: nginx
       version: v1
     clusterIP: None
     ports:
       - name: nginx
         targetPort: 80
         nodePort: 0
         port: 80
         protocol: TCP
     type: ClusterIP
   
   

3. Создайте workload.

   kubectl create -f nginx-statefulset.yaml
   
   

   Если отображается информация, аналогичная следующей, StatefulSet был создан:

   statefulset.apps/nginx created
   
   

   Создайте headless Service.

   kubectl create -f nginx-headless.yaml
   
   

   Если отображается следующая информация, headless service успешно создан.

   service/nginx-svc created
   
   

4. Если к workload будет осуществляться доступ через Service типа ClusterIP или NodePort, настройте режим доступа. Подробнее см. Networking.