Облачная платформаAdvanced

Создание CronJob

Эта статья полезна?
Язык статьи: Русский
Показать оригинал
Страница переведена автоматически и может содержать неточности. Рекомендуем сверяться с английской версией.

CronJob — это рабочая нагрузка Kubernetes, предназначенная для выполнения периодических задач, аналогично crontab в Linux. CronJob используют формат Cron. Они периодически выполняют задания по заранее определённым расписаниям.

CronJob помогают автоматизировать и управлять задачами, обеспечивая их своевременное выполнение и снижая нагрузку ручного управления. Они подходят для различных сценариев, включая:

  • Periodic backups: Необходимо периодически выполнять задачи резервного копирования, такие как резервные копии баз данных и файловых систем.
  • Data synchronization: Данные периодически синхронизируются с основного узла на вторичный узел или облачное хранилище.
  • Log clearing: Необходимо периодически удалять старые файлы журналов, чтобы освободить место в хранилище.
  • Periodic report: Необходимо периодически генерировать и отправлять отчёты, такие как отчёты о состоянии системы и отчёты о производительности.
  • Maintenance tasks: Необходимо выполнять регулярные задачи обслуживания системы, такие как очистка кэша и обновление компонентов.
  • Scheduled tasks: Необходимо выполнять конкретные задачи в определённый момент времени или в течение периода, такие как перезапуск сервисов и проверка состояния.

Требования

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

Использование консоли CCE

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

    Parameter

    Description

    Workload Type

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

    Workload Name

    Введите имя для рабочей нагрузки. Введите от 1 до 52 символов, начинающихся со строчной буквы и заканчивающихся строчной буквой или цифрой. Разрешены только строчные буквы, цифры и дефисы (-).

    Namespace

    Выберите пространство имён для рабочей нагрузки. Значение по умолчанию — default. Вы также можете нажать Create Namespace, чтобы создать его. Для получения подробной информации см. Creating a Namespace.

  4. Настройте container settings для рабочей нагрузки.

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

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

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

        Parameter

        Description

        Container Name

        Введите имя контейнера.

        Pull Policy

        Image update or pull policy. Если вы выбираете Always, образ загружается из репозитория образов каждый раз. Если вы не выбираете Always, предпочтительно используется существующий образ узла. Если образ отсутствует, он загружается из репозитория образов.

        Image Name

        Нажмите Select Image и выберите образ, используемый контейнером.

        Чтобы использовать сторонний образ, напрямую введите путь к образу. Убедитесь, что image access credential может использоваться для доступа к репозиторию образов. Подробности см. 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

        Программы в privileged container имеют определённые привилегии. Если эта опция включена, контейнеру будут предоставлены привилегии. Например, privileged containers могут управлять сетевыми устройствами на хост‑машине, изменять параметры ядра, получать доступ ко всем устройствам узла.

        Для получения дополнительной информации см. Pod Security Standards.

        (Optional) Init Container

        Определяет, использовать ли контейнер в качестве init container. Init container не поддерживает проверку состояния.

        Init container — это специальный контейнер, который запускается до запуска остальных контейнеров приложений в pod. Каждый pod может содержать несколько контейнеров. Кроме того, pod может содержать один или несколько init containers. Контейнеры приложений в pod запускаются и работают только после завершения работы всех init containers. Подробности см. Init Containers.

        (Optional) Run Option

        Добавьте параметры запуска для контейнера. Для получения подробной информации см. Pod. CCE поддерживает следующие параметры запуска:

        • stdin: позволяет контейнерам получать ввод из внешних источников, таких как терминалы или другие потоки ввода.
        • tty: выделяет псевдотерминал контейнерам, позволяя отправлять им команды так, как если бы вы использовали локальный терминал.

          В большинстве случаев tty включается вместе со stdin, указывая, что терминал (tty) связан со стандартным вводом (stdin) контейнера. Это позволяет выполнять интерактивные операции, аналогичные команде kubectl exec -i -t. Разница заключается в том, что этот параметр настраивается при запуске pod.

      • (Optional) Lifecycle: Настройте операции, которые будут выполняться в определённой фазе жизненного цикла контейнера, например команду запуска, Post-Start и Pre-Stop. Для получения подробной информации см. Configuring the Container Lifecycle.
      • (Optional) Environment Variables: Настройте переменные для среды выполнения контейнера, используя пары ключ‑значение. Эти переменные передают внешнюю информацию контейнерам, работающим в pod, и могут гибко изменяться после развертывания приложения. Для получения подробной информации см. Configuring Environment Variables.
    • Image Access Credential: Выберите учётные данные, используемые для доступа к репозиторию образов. Значение по умолчанию — default-secret. Вы можете использовать default-secret для доступа к образам в SWR Shared Edition. Для получения подробной информации о default-secret см. default-secret.
    • (Optional) GPU: По умолчанию выбрано All. Инстанс рабочей нагрузки будет запланирован на узел указанного типа GPU.

  5. Настройте execution settings.

    Parameter

    Description

    Concurrency Policy

    Поддерживаются следующие режимы:

    • Forbid: Новый job может быть создан только после завершения предыдущего.
    • Allow: CronJob позволяет одновременно выполнять несколько job, которые используют ресурсы кластера.
    • Заменить: Если пришло время запускать новую задачу, но предыдущая задача ещё не завершилась, CronJob заменяет текущую выполняющуюся задачу новой.

    Настройки политики

    Укажите, когда будет выполнен новый CronJob. Настройки политики в YAML реализуются с помощью cron-выражений.

    • CronJob выполняется с фиксированным интервалом. Единица может быть минутой, часом, днём или месяцем. Например, если CronJob выполняется каждые 30 минут, его cron-выражение выглядит так */30 * * * *. Задача будет выполняться с интервалом 30 минут, начиная с начала часа, например, 00:00:00, 00:30:00, 01:00:00 и ....
    • CronJob выполняется в фиксированное время (по месяцам). Например, если CronJob выполняется в 00:00 первого дня каждого месяца, его cron-выражение выглядит так 0 0 1 */1 *. Задача будет выполнена в ****-01-01 00:00:00, ****-02-01 00:00:00 и ....
    • CronJob выполняется еженедельно. Например, если CronJob выполняется в 00:00 каждый понедельник, его cron-выражение выглядит так 0 0 * * 1. Задача будет выполнена в ****-**-01 00:00:00 в понедельник, ****-**-08 00:00:00 в понедельник и ....
    • Custom Cron Expression: Для получения подробностей о том, как использовать cron-выражения, см. CronJob.
    ПРИМЕЧАНИЕ:
    • Если CronJob выполняется в фиксированное время (по месяцам) и в месяце нет указанного количества дней, CronJob не будет выполнен в этом месяце. Например, выполнение будет пропущено в феврале, если дата установлена на 30.
    • В соответствии с определением cron фиксированный период не является строгим. Диапазон единицы времени делится от 0 по периоду. Например, если единица — минута, значение варьируется от 0 до 59. Если значение нельзя разделить точно, последний период сбрасывается. Поэтому точный период можно представить только тогда, когда период делится без остатка.

      Возьмём CronJob, который запускается каждый час, в качестве примера. Если интервал может делить 24 часа точно, например /2, /3, /4, /6, /8 и /12, период можно точно представить. Однако если используется иной период, последний период будет сбрасываться в начале каждого нового дня. Например, если cron-выражение выглядит так * */12 * * *, задача будет запускаться в 00:00:00 и 12:00:00 каждый день. Аналогично, если cron-выражение выглядит так * */13 * * *, задача будет запускаться в 00:00:00 и 13:00:00 каждый день. Обратите внимание, что последний период будет сбрасываться в 00:00:00 следующего дня, даже если не прошли 13 часов.

    Часовой пояс

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

    Записи задач

    Настройте количество успешных или неуспешных задач, которые сохраняются. Если значение установлено в 0, задачи не будут сохраняться после завершения или сбоя.

  6. (Необязательно) Настройте advanced settings для рабочей нагрузки.

    Параметр

    Описание

    Метки и аннотации

    Добавьте метки или аннотации для pod‑ов, используя пары ключ‑значение. После настройки нажмите Confirm. Подробную информацию о метках и аннотациях см. в Configuring Labels and Annotations.

    Настройка сети

    • Ограничение пропускной способности входящего/исходящего трафика pod: Вы можете задать ограничения пропускной способности входящего и исходящего трафика для pod‑ов. Подробную информацию см. в Configuring QoS for a Pod.
    • Включить ли указанную container network configuration: доступно только для кластеров, поддерживающих эту функцию. После включения указанной container network configuration рабочая нагрузка будет использовать подсеть и группу безопасности, определённые в конфигурации. Подробную информацию см. в Binding a Subnet and Security Group to a Namespace or Workload Using a Container Network Configuration.
    • Укажите container network configuration name: можно выбрать только пользовательскую container network configuration, тип связанного ресурса которой — workload.
    • Общая пропускная способность IPv6: доступно только для кластеров, поддерживающих эту функцию. После включения функции вы можете настроить общую пропускную способность для pod‑а с сетевыми интерфейсами IPv6 dual‑stack. Подробную информацию см. в Configuring a Shared Bandwidth for Dual-Stack Pods in a CCE Turbo Cluster.

  7. Нажмите Create Workload в правом нижнем углу и проверьте, изменился ли статус рабочей нагрузки на Started.

Использование kubectl

CronJob имеет следующие параметры конфигурации:

  • .spec.schedule: принимает строку формата Cron, например, 0 * * * * или @hourly, в качестве времени планирования задач, которые будут созданы и выполнены.
  • .spec.jobTemplate: указывает задачи для выполнения и имеет ту же схему, что и при Creating a Job Using kubectl.
  • .spec.startingDeadlineSeconds: указывает срок для запуска задания.
  • .spec.concurrencyPolicy: указывает, как обрабатывать одновременные выполнения задания, созданного CronJob. Поддерживаются следующие варианты:
    • Allow (значение по умолчанию): позволяет одновременно выполнять задания.
    • Forbid: запрещает одновременные запуски, пропуская следующий запуск, если предыдущий ещё не завершён.
    • Replace: отменяет текущий запущенный задание и заменяет его новым.

Ниже приведён пример CronJob, который сохраняется в файле cronjob.yaml.

Note

В кластерах версии v1.21 и новее apiVersion CronJob имеет значение batch/v1.

В кластерах версии ниже v1.21 apiVersion CronJob имеет значение batch/v1beta1.

apiVersion: batch/v1
kind: CronJob
metadata:
name: hello
spec:
schedule: "*/1 * * * *" # The job is executed every minute.
jobTemplate:
spec:
template:
spec:
containers:
- name: hello
image: busybox
command:
- /bin/sh
- -c
- date; echo Hello from the Kubernetes cluster
restartPolicy: OnFailure
imagePullSecrets:
- name: default-secret

Запустить задание.

  1. Создать CronJob.

    kubectl create -f cronjob.yaml

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

    cronjob.batch/hello created

  2. Проверьте состояние выполнения CronJob:

    kubectl get cronjob

    Вывод команды:

    NAME SCHEDULE TIMEZONE SUSPEND ACTIVE LAST SCHEDULE AGE
    hello */1 * * * * <none> False 0 59s 2m36s

  3. Проверьте задание, которое запускается по расписанию.

    kubectl get jobs

    Вывод команды:

    NAME COMPLETIONS DURATION AGE
    hello-1597387980 1/1 27s 45s

  4. Проверьте pods, запущенные job.

    kubectl get pod

    Вывод команды:

    NAME READY STATUS RESTARTS AGE
    hello-1597387980-tjv8f 0/1 Completed 0 114s

  5. Проверьте pod‑логи. Ожидается, что в логах будет отображено "Hello from the Kubernetes cluster".

    kubectl logs hello-1597387980-tjv8f

    Вывод команды:

    Fri Aug 14 06:56:31 UTC 2020
    Hello from the Kubernetes cluster

  6. Удалите CronJob. При удалении CronJob связанные задачи и pods удаляются соответствующим образом.

    kubectl delete cronjob hello

    Вывод команды:

    cronjob.batch "hello" deleted

Связанные операции

После создания CronJob вы можете выполнить операции, перечисленные в Table 1.

Table 1 Другие операции

Operation

Description

Редактирование YAML‑файла

Нажмите More > Edit YAML рядом с именем CronJob, чтобы отредактировать YAML‑файл текущего job.

Остановка CronJob

  1. Выберите job, который нужно остановить, и нажмите Stop в столбце Operation.
  2. нажмите Yes.

Удаление CronJob

  1. Выберите целевой CronJob и выберите More > Delete в Operation столбце.
  2. нажмите Yes.

    Удалённые задания нельзя восстановить. Будьте осторожны при удалении задания.