Spec-Zone.ru › AWS CLI v2

[ aws . deadline ]

создать-флот

Описание

Создаёт флот. Флоты собирают информацию, относящуюся к вычислительным ресурсам или ёмкости для рендеринга внутри ваших ферм. Вы можете выбрать управление собственной ёмкостью или передать управление флотами полностью Deadline Cloud.

См. также: Документация API AWS

Синтаксис

  create-fleet
[--client-token <value>]
--farm-id <value>
--display-name <value>
[--description <value>]
--role-arn <value>
[--min-worker-count <value>]
--max-worker-count <value>
--configuration <value>
[--tags <value>]
[--host-configuration <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--client-token (строка)

Уникальный маркер, который сервер использует для распознавания повторных попыток одного и того же запроса.

--farm-id (строка)

Идентификатор фермы, к которой должен подключиться флот.

--display-name (строка)

Имя отображения флота.

Предупреждение

Это поле может хранить любое содержимое. Перед отображением этого содержимого на веб-странице или любом другом системном элементе, который может интерпретировать содержимое этого поля, необходимо выполнить экранирование или кодирование.

--description (строка)

Описание флота.

Предупреждение

Это поле может хранить любое содержимое. Перед отображением этого содержимого на веб-странице или любом другом системном элементе, который может интерпретировать содержимое этого поля, необходимо выполнить экранирование или кодирование.

--role-arn (строка)

ARN роли IAM для роли, которую будут использовать рабочие флота.

--min-worker-count (целое число)

Минимальное количество рабочих для флота.

--max-worker-count (целое число)

Максимальное количество рабочих для флота.

Deadline Cloud ограничивает количество рабочих значением, меньшим или равным максимальному количеству рабочих в флоте. Служба поддерживает конечную согласованность для количества рабочих. Если вы выполните несколько быстрых вызовов CreateWorker до обновления поля, вы можете превысить максимальное количество рабочих в вашем флоте. Например, если ваш maxWorkerCount составляет 10, а у вас сейчас 9 рабочих, два быстрых вызова CreateWorker могут успешно создать 2 рабочих вместо 1, что приведёт к 11 рабочим в общей сложности.

--configuration (структура помеченного объединения)

Параметры конфигурации флота. Клиентские управляемые флоты управляются самостоятельно. Управляемые Amazon EC2 флоты сервисом управляются Deadline Cloud.

Примечание

Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан: customerManaged, serviceManagedEc2.

customerManaged -> (структура)

Клиентские управляемые флоты внутри конфигурации флота.

mode -> (строка)

Режим автоматического масштабирования для конфигурации клиентского управляемого флота.

workerCapabilities -> (структура)

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

vCpuCount -> (структура)

Количество vCPU для возможностей рабочих клиентского управляемого флота.

min -> (целое число)

Минимальное количество vCPU.

max -> (целое число)

Максимальное количество vCPU.

memoryMiB -> (структура)

Память (MiB).

min -> (целое число)

Минимальный объём памяти (в MiB).

max -> (целое число)

Максимальный объём памяти (в MiB).

acceleratorTypes -> (список)

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

(строка)

acceleratorCount -> (структура)

Диапазон ускорителей.

min -> (целое число)

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

max -> (целое число)

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

acceleratorTotalMemoryMiB -> (структура)

Общий объём памяти (MiB) для возможностей рабочих клиентского управляемого флота.

min -> (целое число)

Минимальный объём памяти для использования ускорителя, измеренный в MiB.

max -> (целое число)

Максимальный объём памяти для использования ускорителя, измеренный в MiB.

osFamily -> (строка)

Семейство операционных систем (ОС).

cpuArchitectureType -> (строка)

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

customAmounts -> (список)

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

(структура)

Количество и атрибуты возможностей флота.

name -> (строка)

Имя возможности флота.

min -> (число с плавающей точкой)

Минимальное значение возможности рабочего флота.

max -> (число с плавающей точкой)

Максимальное значение возможности рабочего флота.

customAttributes -> (список)

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

(структура)

Определяет имя возможности флота, минимум и максимум.

name -> (строка)

Имя атрибута возможности флота для рабочего.

values -> (список)

Количество атрибутов возможностей флота.

(строка)

storageProfileId -> (строка)

Идентификатор профиля хранения.

tagPropagationMode -> (строка)

Указывает, прикрепляются ли теги, связанные с флотом, к рабочим при запуске рабочего.

Если tagPropagationMode установлен на PROPAGATE_TAGS_TO_WORKERS_AT_LAUNCH, любой тег, связанный с флотом, прикрепляется к рабочим при их запуске. Если теги для флота изменятся, теги, связанные с работающими рабочими, не изменятся.

Если вы не укажете tagPropagationMode, по умолчанию будет NO_PROPAGATION.

serviceManagedEc2 -> (структура)

Управляемые сервисом экземпляры Amazon EC2 для конфигурации флота.

instanceCapabilities -> (структура)

Возможности экземпляра Amazon EC2.

vCpuCount -> (структура)

Количество vCPU, необходимое для экземпляров в этом флоте.

min -> (целое число)

Минимальное количество vCPU.

max -> (целое число)

Максимальное количество vCPU.

memoryMiB -> (структура)

Память в MiB для типа экземпляра Amazon EC2.

min -> (целое число)

Минимальный объём памяти (в MiB).

max -> (целое число)

Максимальный объём памяти (в MiB).

osFamily -> (строка)

Семейство операционных систем (ОС).

cpuArchitectureType -> (строка)

Тип архитектуры процессора.

rootEbsVolume -> (структура)

Основной том EBS.

sizeGiB -> (целое число)

Размер тома EBS в GiB.

iops -> (целое число)

IOPS на том.

throughputMiB -> (целое число)

Пропускная способность на том в MiB.

acceleratorCapabilities -> (структура)

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

selections -> (список)

Список запрошенных возможностей ускорителей графических процессоров для этого флота. Будут использованы только экземпляры Amazon Elastic Compute Cloud, предоставляющие эти возможности. Например, если вы указали как L4, так и T4 чипы, Deadline Cloud будет использовать экземпляры Amazon EC2, имеющие либо L4, либо T4 чип.

(структура)

Описание конкретного ускорителя графического процессора, необходимого для узла рабочего Amazon Elastic Compute Cloud.

name -> (строка)

Имя чипа, используемого ускорителем графического процессора.

Если вы укажете l4 в качестве имени ускорителя, вы должны указать latest или grid:r550 в качестве среды выполнения.

Доступные ускорители графических процессоров:

  • t4 - NVIDIA T4 Tensor Core GPU
  • a10g - NVIDIA A10G Tensor Core GPU
  • l4 - NVIDIA L4 Tensor Core GPU
  • l40s - NVIDIA L40S Tensor Core GPU

runtime -> (строка)

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

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

  • latest - Используйте последнюю доступную среду выполнения для чипа. Если вы укажете latest, а новая версия среды выполнения будет выпущена, будет использована новая версия среды выполнения.
  • grid:r550 - NVIDIA vGPU software 17
  • grid:r535 - NVIDIA vGPU software 16

Если вы не укажете среду выполнения, Deadline Cloud использует latest в качестве значения по умолчанию. Однако, если у вас несколько ускорителей и вы укажете latest для некоторых и оставите другие пустыми, Deadline Cloud вызовет исключение.

count -> (структура)

Количество ускорителей графических процессоров, указанных для узлов рабочих в этом флоте.

min -> (целое число)

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

max -> (целое число)

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

allowedInstanceTypes -> (список)

Допустимые типы экземпляров Amazon EC2.

(строка)

excludedInstanceTypes -> (список)

Типы экземпляров, которые нужно исключить из флота.

(строка)

customAmounts -> (список)

Пользовательские объёмы возможностей, которые нужно потребовать от экземпляров в этом флоте.

(структура)

Количество и атрибуты возможностей флота.

name -> (строка)

Имя возможности флота.

min -> (число с плавающей точкой)

Минимальное значение возможности рабочего флота.

max -> (число с плавающей точкой)

Максимальное значение возможности рабочего флота.

customAttributes -> (список)

Атрибуты пользовательских возможностей, которые нужно потребовать от экземпляров в этом флоте.

(структура)

Определяет имя возможности флота, минимум и максимум.

name -> (строка)

Имя атрибута возможности флота для рабочего.

values -> (список)

Количество атрибутов возможностей флота.

(строка)

instanceMarketOptions -> (структура)

Тип рынка Amazon EC2.

type -> (строка)

Тип экземпляра Amazon EC2.

Синтаксис JSON:

{
  "customerManaged": {
    "mode": "NO_SCALING"|"EVENT_BASED_AUTO_SCALING",
    "workerCapabilities": {
      "vCpuCount": {
        "min": integer,
        "max": integer
      },
      "memoryMiB": {
        "min": integer,
        "max": integer
      },
      "acceleratorTypes": ["gpu", ...],
      "acceleratorCount": {
        "min": integer,
        "max": integer
      },
      "acceleratorTotalMemoryMiB": {
        "min": integer,
        "max": integer
      },
      "osFamily": "WINDOWS"|"LINUX"|"MACOS",
      "cpuArchitectureType": "x86_64"|"arm64",
      "customAmounts": [
        {
          "name": "string",
          "min": float,
          "max": float
        }
        ...
      ],
      "customAttributes": [
        {
          "name": "string",
          "values": ["string", ...]
        }
        ...
      ]
    },
    "storageProfileId": "string",
    "tagPropagationMode": "NO_PROPAGATION"|"PROPAGATE_TAGS_TO_WORKERS_AT_LAUNCH"
  },
  "serviceManagedEc2": {
    "instanceCapabilities": {
      "vCpuCount": {
        "min": integer,
        "max": integer
      },
      "memoryMiB": {
        "min": integer,
        "max": integer
      },
      "osFamily": "WINDOWS"|"LINUX",
      "cpuArchitectureType": "x86_64"|"arm64",
      "rootEbsVolume": {
        "sizeGiB": integer,
        "iops": integer,
        "throughputMiB": integer
      },
      "acceleratorCapabilities": {
        "selections": [
          {
            "name": "t4"|"a10g"|"l4"|"l40s",
            "runtime": "string"
          }
          ...
        ],
        "count": {
          "min": integer,
          "max": integer
        }
      },
      "allowedInstanceTypes": ["string", ...],
      "excludedInstanceTypes": ["string", ...],
      "customAmounts": [
        {
          "name": "string",
          "min": float,
          "max": float
        }
        ...
      ],
      "customAttributes": [
        {
          "name": "string",
          "values": ["string", ...]
        }
        ...
      ]
    },
    "instanceMarketOptions": {
      "type": "on-demand"|"spot"
    }
  }
}

--tags (словарь)

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

key -> (строка)

value -> (строка)

Краткая запись:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--host-configuration (структура)

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

scriptBody -> (строка)

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

Дополнительную информацию об использовании скрипта см. в руководстве разработчика Deadline Cloud, раздел «Запуск скриптов администратором для настройки рабочих» (Run scripts as an administrator to configure workers in the Deadline Cloud Developer Guide).

Предупреждение

Скрипт выполняется от имени администратора (sudo root в Linux, как администратор в Windows).

scriptTimeoutSeconds -> (целое число)

Максимальное время выполнения конфигурации хоста. Если таймаут истекает, рабочий переходит в состояние NOT RESPONDING и завершается. Вы оплачиваете время выполнения скрипта конфигурации хоста работником.

Примечание

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

По умолчанию значение равно 300 секундам (5 минутам).

Сокращенная синтаксическая запись:

scriptBody=string,scriptTimeoutSeconds=integer

Синтаксис JSON:

{
  "scriptBody": "string",
  "scriptTimeoutSeconds": integer
}

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Передавать произвольные двоичные значения с помощью значения JSON, предоставленного как строку, невозможно, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит скелет JSON в стандартный вывод без отправки запроса API. При отсутствии значения или значении input выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. При указании значения output проверяются входные данные команд и возвращается пример выходного JSON для этой команды. Сгенерированный скелет JSON нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном скелете JSON.

Глобальные параметры

--debug (логическое значение)

Включить отладку регистрации.

--endpoint-url (строка)

Переопределить стандартный URL команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команд.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

Файл сертификата CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет рассматриваться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для заданной настройки cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод пейджера CLI.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров ввода CLI.

Вывод

fleetId -> (строка)

Идентификатор флота.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API