Модуль google.cloud.gcp_vertexai_deployment_resource_pool — создает ресурс GCP VertexAI.DeploymentResourcePool
Примечание
Этот модуль входит в коллекцию google.cloud (версия 1.13.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля нужны дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: google.cloud.gcp_vertexai_deployment_resource_pool.
Краткое описание
- «DeploymentResourcePool можно совместно использовать для нескольких развернутых моделей,
- базовая спецификация которых включает выделенные ресурсы».
Требования
На хосте, на котором выполняется этот модуль, должны быть установлены следующие компоненты.
- python >= 3.8
- requests >= 2.18.4
- google-auth >= 2.25.1
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен доступа, используемый для аутентификации. |
auth_kind string / обязательный | Тип используемых учетных данных. Варианты:
|
dedicated_resources dictionary | Базовые выделенные ресурсы, используемые пулом ресурсов развертывания. |
|
autoscaling_metric_specs list / элементы=dictionary |
Список спецификаций метрик, переопределяющих метрику использования ресурсов. |
|
metric_name string / обязательный |
Название метрики ресурса. Поддерживаемые метрики для онлайн-прогнозирования: * `aiplatform.googleapis.com/prediction/online/accelerator/duty_cycle` * `aiplatform.googleapis.com/prediction/online/cpu/utilization`. |
|
target integer |
Целевой уровень использования ресурса в процентах (1–100 %) для указанной метрики; если фактическое использование отклонится от целевого на определенный процент, количество реплик машин изменится. Если значение не указано, по умолчанию используется 60 (что соответствует 60 %). |
|
machine_spec dictionary / обязательный |
Спецификация одной машины, используемой для прогнозирования. |
|
accelerator_count integer |
Количество ускорителей, подключаемых к машине. |
|
accelerator_type string |
Тип ускорителя или ускорителей, которые можно подключить к машине в соответствии со значением accelerator_count. Допустимые значения см. здесь. |
|
machine_type string |
Тип машины. |
|
max_replica_count integer |
Максимальное количество реплик, на которых может быть развернута эта модель, если трафик к ней увеличится. Если запрошенное значение слишком велико, развертывание завершится ошибкой. Если развертывание пройдет успешно, возможность масштабирования модели до указанного количества реплик гарантируется (за исключением случаев перебоев в работе сервиса). Если трафик к развернутой модели превысит возможности ее максимального количества реплик, часть трафика будет отброшена. Если значение не указано, по умолчанию используется min_replica_count. Значение этого поля влияет на расход квот Vertex CPU и GPU. В частности, с вас будет взиматься плата за max_replica_count * количество ядер в выбранном типе машины) и (max_replica_count * количество GPU на реплику в выбранном типе машины). |
|
min_replica_count integer / обязательный |
Минимальное количество реплик машин, на которых эта развернутая модель будет постоянно развернута. Это значение должно быть не меньше 1. При увеличении трафика к развернутой модели она может динамически размещаться на большем количестве реплик, а при уменьшении трафика некоторые дополнительные реплики могут быть освобождены. |
env_type string | Указывает, в какой среде Ansible выполняется этот модуль. Не задавайте этот параметр, если не знаете, что делаете. Он изменяет только строку User Agent для запросов к API. |
name string / обязательный | Имя ресурса пула ресурсов развертывания. Максимальная длина — 63 символа; допустимые символы соответствуют выражению `/^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/`. |
project string | Проект Google Cloud Platform, который следует использовать. |
region string | Регион пула ресурсов развертывания. Например, us-central1. |
scopes list / элементы=string | Массив используемых областей действия. |
service_account_contents jsonarg | Содержимое JSON-файла учетной записи службы в виде словаря или строки JSON, представляющей это содержимое. |
service_account_email string | Необязательный адрес электронной почты учетной записи службы, если выбрана machineaccount и пользователь не хочет использовать адрес по умолчанию. |
service_account_file path | Путь к JSON-файлу учетной записи службы, если в качестве типа выбрано serviceaccount. |
state string | Должен ли ресурс существовать в GCP. Варианты:
|
Примечания
Примечание
- Справочник API: https://cloud.google.com/vertex-ai/docs/reference/rest/v1/projects.locations.deploymentResourcePools
- Для аутентификации можно задать auth_kind с помощью переменной окружения
GCP_AUTH_KIND. - Для аутентификации можно задать service_account_file с помощью переменной окружения
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно задать service_account_contents с помощью переменной окружения
GCP_SERVICE_ACCOUNT_CONTENTS. - Для аутентификации можно задать service_account_email с помощью переменной окружения
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно задать access_token с помощью переменной окружения
GCP_ACCESS_TOKEN. - Для аутентификации можно задать scopes с помощью переменной окружения
GCP_SCOPES. - Значения переменных окружения используются только в том случае, если значения не заданы в плейбуке.
- Параметры
service_account_email,service_account_file,service_account_fileиaccess_tokenявляются взаимоисключающими.
Примеры
- name: Create Deployment Resource Pool
google.cloud.gcp_vertexai_deployment_resource_pool:
state: present
name: my_deployment_resource_pool
dedicated_resources:
min_replica_count: 1
max_replica_count: 3
machine_spec:
machine_type: n1-standard-4
accelerator_type: NVIDIA_TESLA_P4
accelerator_count: 1
region: us-central1
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
changed boolean | Был ли изменен ресурс. Возвращается: всегда |
createTime string | Метка времени в формате RFC3339 UTC «Zulu» с точностью до наносекунд и не более чем девятью дробными цифрами. Возвращается: при успешном выполнении |
state string | Текущее состояние ресурса. Возвращается: всегда |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/google/cloud/gcp_vertexai_deployment_resource_pool_module.html
