gcp_compute_image_facts – Сбор фактов для изображения GCP
Новое в версии 2.7.
Обзор
- Сбор фактов для изображения GCP
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth_kind - / обязательно |
| Тип используемых учетных данных. |
| filters - | Список пар значений фильтров. Доступные фильтры перечислены здесь https://cloud.google.com/sdk/gcloud/reference/topic/filters. Каждый дополнительный фильтр в списке будет добавлен как условие И (filter1 и filter2) | |
| project - | Значение по умолчанию: null | Проект Google Cloud Platform, который нужно использовать. |
| scopes - | Массив используемых областей. | |
| service_account_email - | Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию. | |
| service_account_file - | Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount. |
Примечания
Примечание
- Для аутентификации можно установить service_account_file с помощью переменной среды
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно установить service_account_email с помощью переменной среды
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно установить auth_kind с помощью переменной среды
GCP_AUTH_KIND. - Для аутентификации можно установить scopes с помощью переменной среды
GCP_SCOPES. - Значения переменных среды будут использоваться только в том случае, если значения в playbook не заданы.
- Параметры service_account_email и service_account_file взаимоисключающие.
Примеры
- name: a image facts
gcp_compute_image_facts:
filters:
- name = test_object
project: test_project
auth_kind: service_account
service_account_file: "/tmp/auth.pem"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, ниже перечислены поля, уникальные для данного модуля:
| Ключ | Возвращаемое | Описание | ||
|---|---|---|---|---|
| items сложный | всегда | Список элементов | ||
| archive_size_bytes целое число | успех | Размер архива tar.gz с изображением, хранящегося в Google Cloud Storage (в байтах). | ||
| creation_timestamp строка | успех | Маркер времени создания в формате RFC3339. | ||
| deprecated сложный | успех | Статус устаревания, связанный с этим изображением. | ||
| deleted строка | успех | Необязательный отметка времени RFC3339, начиная с которой состояние этого ресурса предполагается изменить на УДАЛЕН. Это только информационное сообщение, и статус не изменится, если клиент явно не изменит его. | ||
| deprecated строка | успех | Необязательный отметка времени RFC3339, начиная с которой состояние этого ресурса предполагается изменить на УСТАРЕВШИЙ. Это только информационное сообщение, и статус не изменится, если клиент явно не изменит его. | ||
| obsolete строка | успех | Необязательный отметка времени RFC3339, начиная с которой состояние этого ресурса предполагается изменить на УСТАРЕВШИЙ. Это только информационное сообщение, и статус не изменится, если клиент явно не изменит его. | ||
| replacement строка | успех | URL рекомендуемого ресурса-замены для устаревшего ресурса. Рекомендуемый ресурс-замена должен быть того же типа, что и устаревший ресурс. | ||
| state строка | успех | Состояние устаревания этого ресурса. Это может быть УСТАРЕВШИЙ, УСТАРЕВШИЙ или УДАЛЕННЫЙ. Операции, создающие новый ресурс с использованием устаревшего ресурса, будут успешно выполнены, но с предупреждением, указывающим на устаревший ресурс и рекомендуя его замену. Операции, использующие устаревшие или удаленные ресурсы, будут отклонены и приведут к ошибке. | ||
| description строка | успех | Необязательное описание этого ресурса. Укажите это свойство при создании ресурса. | ||
| disk_size_gb целое число | успех | Размер изображения при восстановлении на постоянный диск (в ГБ). | ||
| family строка | успех | Имя семейства изображений, к которому принадлежит это изображение. Вы можете создавать диски, указав семейство изображений вместо имени конкретного изображения. Семейство изображений всегда возвращает свое последнее изображение, которое не устарело. Имя семейства изображений должно соответствовать RFC1035. | ||
| guest_os_features сложный | успех | Список функций для включения в гостевой ОС. Применимо только для загружаемых изображений. В настоящее время можно включить только одну функцию, VIRTIO_SCSI_MULTIQUEUE, которая позволяет каждой виртуальной ЦП иметь свою очередь. Для изображений Windows вы можете включить VIRTIO_SCSI_MULTIQUEUE только для изображений с версией драйвера 1.2.0.1621 или выше. Изображения Linux с ядрами версии 3.17 и выше будут поддерживать VIRTIO_SCSI_MULTIQUEUE. Для новых изображений Windows сервер может также заполнить это поле значением WINDOWS, чтобы указать, что это изображение Windows. Это значение является чисто информативным и не включает или не отключает какие-либо функции. | ||
| type строка | успех | Тип поддерживаемой функции. В настоящее время поддерживается только VIRTIO_SCSI_MULTIQUEUE. Для более новых изображений Windows сервер может также заполнить это свойство значением WINDOWS, чтобы указать, что это изображение Windows. Это значение является чисто информативным и не включает или не отключает какие-либо функции. | ||
| id целое число | успех | Уникальный идентификатор ресурса. Этот идентификатор определяется сервером. | ||
| image_encryption_key сложный | успех | Шифрует изображение с помощью предоставленного клиентом ключа шифрования. После шифрования изображения с предоставленным клиентом ключом, вы должны предоставить тот же ключ, если вы используете изображение позже (например, для создания диска из изображения). | ||
| raw_key строка | успех | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или дешифрования этого ресурса. | ||
| sha256 строка | успех | Закодированный в RFC 4648 base64 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс. | ||
| licenses список | успех | Любой применимый URI лицензии. | ||
| name строка | успех | Имя ресурса; предоставляется клиентом при создании ресурса. Имя должно быть длиной от 1 до 63 символов и соответствовать RFC1035. В частности, имя должно быть длиной от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть тире, строчной буквой или цифрой, за исключением последнего символа, который не может быть тире. | ||
| raw_disk сложный | успех | Параметры изображения необработанного диска. | ||
| container_type строка | успех | Формат, используемый для кодирования и передачи блочного устройства, который должен быть TAR. Это просто контейнерный и передаточный формат, а не формат выполнения. Предоставляется клиентом при создании образа диска. | ||
| sha1_checksum строка | успех | Необязательная проверка SHA1 образа диска перед распаковкой. Это предоставляется клиентом при создании образа диска. | ||
| source строка | успех | Полный URL Google Cloud Storage, где хранится хранилище диска. Вы должны указать либо это свойство, либо свойство sourceDisk, но не оба. | ||
| source_disk словарь | успех | Ссылка на объект gcompute_disk. Вы должны указать либо это свойство, либо свойство rawDisk.source, но не оба, чтобы создать образ. | ||
| source_disk_encryption_key сложный | успех | Ключ шифрования, предоставленный клиентом, для исходного диска. Требуется, если исходный диск защищен ключом шифрования, предоставленным клиентом. | ||
| raw_key строка | успех | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или дешифрования этого ресурса. | ||
| sha256 строка | успех | Закодированный в RFC 4648 base64 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс. | ||
| source_disk_id строка | успех | Значение ID диска, используемого для создания этого образа. Это значение может быть использовано для определения, был ли образ взят с текущего или предыдущего экземпляра с заданным именем диска. | ||
| source_type строка | успех | Тип изображения, используемого для создания этого диска. По умолчанию и единственное значение - RAW. | ||
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Google Inc. (@googlecloudplatform)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/gcp_compute_image_facts_module.html
