# PodGroup API
LLMS index: [llms.txt](/llms.txt)
---
СТАН ФУНКЦІОНАЛУ:
Kubernetes v1.35 [alpha](стандартно вимкнено)
PodGroup — це обʼєкт середовища виконання, який представляє групу Podʼів, запланованих для роботи як єдине ціле. У той час як [Workload API](/docs/concepts/workloads/workload-api/) визначає шаблони політик планування, PodGroups є їхніми аналогами в середовищі виконання, які містять як саму політику, так і стан планування для конкретного екземпляра цієї групи.
## Що таке PodGroup? {#what-is-a-podgroup}
Ресурс API PodGroup є частиною групи API `scheduling.k8s.io/v1alpha2` і ваш кластер повинен мати цю групу API увімкненою, а також функціональну можливість [`GenericWorkload`](/docs/reference/command-line-tools-reference/feature-gates/#GenericWorkload), перш ніж ви зможете використовувати цей API.
PodGroup — це самостійна одиниця планування. Вона визначає групу Podʼів, які повинні бути заплановані разом, містить політику планування, що регулює розміщення, і фіксує стан виконання цього рішення про планування.
## Структура API {#api-structure}
PodGroup складається з розділів `spec`, який визначає бажану поведінку планування, та `status`, який відображає поточний стан планування.
### Політика планування {#scheduling-policy}
Кожна PodGroup має [політику планування](/docs/concepts/workloads/workload-api/policies/) (`basic` або `gang`) у `spec.schedulingPolicy`. Коли контролер робочого навантаження створює PodGroup, ця політика копіюється з PodGroupTemplate робочого навантаження під час створення. Для автономних PodGroup ви встановлюєте політику безпосередньо.
```yaml
spec:
schedulingPolicy:
gang:
minCount: 4
```
### Посилання на шаблон {#template-reference}
Необовʼязкове поле `spec.podGroupTemplateRef` повʼязує PodGroup з PodGroupTemplate у робочому навантаженні, з якого вона була створена. Це корисно для спостереження та інструментів.
```yaml
spec:
podGroupTemplateRef:
workload:
workloadName: training-policy
podGroupTemplateName: worker
```
### Запитування пристроїв DRA для PodGroup {#requesting-dra-devices-for-a-podgroup}
СТАН ФУНКЦІОНАЛУ:
Kubernetes v1.36 [alpha](стандартно вимкнено)
Пристрої доступні через Динамічне виділення ресурсів (DRA) можуть бути запитані PodGroup через поле `spec.resourceClaims`:
```yaml
apiVersion: scheduling.k8s.io/v1alpha2
kind: PodGroup
metadata:
name: training-group
namespace: some-ns
spec:
...
resourceClaims:
- name: pg-claim
resourceClaimName: my-pg-claim
- name: pg-claim-template
resourceClaimTemplateName: my-pg-template
```
ResourceClaims повʼязані з PodGroups можуть бути спільно використані всіма Podʼами, що належать до групи. Замість того, щоб мати посилання на кожен окремий Pod у `status.reservedFor` ResourceClaim, достатньо посилання на PodGroup, і будь-яка кількість Podʼів у тій самій PodGroup може спільно використовувати ResourceClaim. ResourceClaims також можуть бути створені з ResourceClaimTemplates для кожної PodGroup, що дозволяє пристроям, виділеним для кожного створеного ResourceClaim, бути спільно використаними Podʼами в кожній PodGroup.
За докладною інформацією та більш повним прикладом звертайтесь до [документації DRA](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/#workload-resource-claims).
### Статус {#status}
Планувальник оновлює `status.conditions`, щоб повідомити, чи група була успішно запланована. Основною умовою є `PodGroupScheduled`, яка є `True`, коли всі необхідні Podʼи були розміщені, і `False`, коли планування не вдається.
Примітка:
Стан
PodGroupScheduled відображає лише початкове рішення планувальника. Планувальник не оновлює його, якщо Podʼи пізніше зазнають невдачі або будуть виселені. Детальніше див. у розділі
Обмеження.