Spec-Zone.ru › Ansible

модуль google.cloud.gcp_vertexai_feature_online_store – создание ресурса GCP VertexAI.FeatureOnlineStore

Примечание

Этот модуль входит в коллекцию google.cloud (версия 1.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: google.cloud.gcp_vertexai_feature_online_store.

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Vertex AI Feature Online Store предоставляет централизованное хранилище для обслуживания признаков машинного обучения и индексов эмбеддингов с низкой задержкой. Feature Online Store — это контейнер верхнего уровня.

Требования

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

  • python >= 3.8
  • requests >= 2.18.4
  • google-auth >= 2.25.1

Параметры

Параметр

Комментарии

access_token

string

Токен доступа, используемый для аутентификации.

auth_kind

string / обязательный

Тип используемых учетных данных.

Варианты:

  • "accesstoken"
  • "application"
  • "machineaccount"
  • "serviceaccount"

bigtable

dictionary

Настройки экземпляра Cloud Bigtable, который будет создан для обслуживания featureValues всех FeatureViews в этом FeatureOnlineStore.

auto_scaling

dictionary / обязательный

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

cpu_utilization_target

integer

Процент используемой вычислительной мощности кластера.

Может составлять от 10% до 80%.

Когда загрузка ЦП кластера превышает заданный целевой показатель, Bigtable немедленно добавляет узлы в кластер.

Когда загрузка ЦП значительно ниже целевого показателя, Bigtable удаляет узлы.

Если значение не задано, по умолчанию используется 50%.

max_node_count

integer / обязательный

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

Значение должно быть не меньше minNodeCount и не больше десятикратного значения «minNodeCount».

min_node_count

integer / обязательный

Минимальное количество узлов, до которого можно уменьшить кластер.

Значение должно быть не меньше 1.

enable_direct_bigtable_access

boolean

Если значение равно true, разрешает прямой доступ к экземпляру Bigtable.

Варианты:

  • false
  • true

zone

string

Зона, в которой будет создан экземпляр Bigtable.

dedicated_serving_endpoint

dictionary

Выделенная конечная точка обслуживания для этого FeatureOnlineStore, отличающаяся от общей конечной точки службы Vertex.

Ее нужно задавать только при выборе типа хранилища Optimized или включении EmbeddingManagement.

По умолчанию будет использоваться общедоступная конечная точка.

private_service_connect_config

dictionary

Конфигурация Private Service Connect.

enable_private_service_connect

boolean / обязательный

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

В противном случае будет использоваться общедоступная конечная точка.

Варианты:

  • false
  • true

project_allowlist

list / elements=string

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

public_endpoint_domain_name

string

Доменное имя, используемое для этого FeatureOnlineStore.

service_attachment

string

Имя ресурса подключения службы.

Применяется только при включенном Private Service Connect и после создания FeatureViewSync.

embedding_management

dictionary

Настройки управления эмбеддингами в FeatureOnlineStore.

Управление эмбеддингами можно настроить только для BigTable.

Для типа хранилища Optimized эта функция включена по умолчанию.

enabled

boolean

Включить управление эмбеддингами.

Варианты:

  • false
  • true

encryption_spec

dictionary

Если указано значение, этот ключ будет использоваться для защиты данных как в оперативном, так и в автономном хранилище.

kms_key_name

string / обязательный

Идентификатор ресурса Cloud KMS для управляемого клиентом ключа шифрования, используемого для защиты ресурса.

Формат: projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key.

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

env_type

string

Указывает, в какой среде Ansible выполняется этот модуль.

Не задавайте этот параметр, если не знаете, что делаете.

Он изменяет только строку User Agent для всех запросов API.

force_destroy

boolean

Если задано значение true, все FeatureViews и Features для этого FeatureOnlineStore также будут удалены.

Варианты:

  • false ← (по умолчанию)
  • true

labels

dictionary

Метки с определяемыми пользователем метаданными для организации ваших хранилищ признаков.

name

string / обязательный

Имя ресурса Feature Online Store.

Длина значения не должна превышать 60 символов; допустимы символы [a-z0-9_].

Первый символ не может быть цифрой.

optimized

dictionary

Настройки оптимизированного хранилища, которое будет создано для обслуживания featureValues всех FeatureViews в этом FeatureOnlineStore.

project

string

Проект Google Cloud Platform, который следует использовать.

region

string

Регион хранилища признаков.

Например, us-central1.

scopes

list / elements=string

Массив областей доступа для использования.

service_account_contents

jsonarg

Содержимое JSON-файла учетной записи службы:

словарь или представляющая его JSON-строка.

service_account_email

string

Необязательный адрес электронной почты учетной записи службы, если выбрана

учетная запись машины и пользователь не хочет использовать адрес по умолчанию.

service_account_file

path

Путь к JSON-файлу учетной записи службы, если в качестве типа

выбрана учетная запись службы.

state

string

Должен ли ресурс существовать в GCP.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

Примечания

Примечание

  • Справочник API: https://cloud.google.com/vertex-ai/docs/reference/rest/v1/projects.locations.featureOnlineStores
  • Официальное руководство по документации: https://cloud.google.com/vertex-ai/docs
  • Для аутентификации можно задать 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 Feature Online Store
  google.cloud.gcp_vertexai_feature_online_store:
    state: present
    name: my_feature_online_store
    bigtable:
      auto_scaling:
        min_node_count: 1
        max_node_count: 3
        cpu_utilization_target: 50
    region: us-central1
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

changed

boolean

Был ли изменен ресурс.

Возвращается: всегда

createTime

string

Метка времени создания хранилища признаков в формате RFC3339 UTC «Zulu» с наносекундной точностью и не более чем девятью знаками после запятой.

Возвращается: при успешном выполнении

etag

string

Используется для согласованного выполнения операций чтения, изменения и записи.

Возвращается: при успешном выполнении

state

string

Состояние Feature Online Store.

Возможные состояния см. по этой ссылке.

Возвращается: при успешном выполнении

updateTime

string

Метка времени последнего обновления хранилища признаков в формате RFC3339 UTC «Zulu» с наносекундной точностью и не более чем девятью знаками после запятой.

Возвращается: при успешном выполнении

Авторы

  • Google Inc. (@googlecloudplatform)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 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_feature_online_store_module.html

Spec-Zone.ru

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