Ресурс google_compute_image

Синтаксис

Используется google_compute_image, чтобы проверить ресурс Google Image.

Ресурс бета-версии

Этот ресурс имеет поля бета-версии. Чтобы получить доступ к этим полям, включите beta: true в конструктор ресурса.

Примеры

describe google_compute_image(project: 'chef-gcp-inspec', name: 'inspec-image') do
  it { should exist }
  its('disk_size_gb') { should cmp 3 }
end

describe google_compute_image(project: 'chef-gcp-inspec', name: 'notfound') do
  it { should_not exist }
end

Проверка состояния ресурса GCP compute image (например, «READY» означает готовность к использованию)

describe google_compute_image(project: 'chef-inspec-gcp', location: 'europe-west2', name: 'compute-address') do
  its('status') { should eq "READY" }
end

Проверка соответствия семейства GCP compute image ожидаемому значению

describe google_compute_image(project: 'chef-inspec-gcp', name: 'ubuntu') do
  its('family') { should match "ubuntu" }
end

Свойства

Свойства, к которым можно получить доступ из ресурса google_compute_image:

archive_size_bytes

Размер архива изображения tar.gz, хранящегося в Google Cloud Storage (в байтах).

creation_timestamp

Маркер создания в формате RFC3339.

deprecated

Статус устаревания данного изображения.

deleted

Необязательный маркер RFC3339, начиная с которого состояние ресурса должно быть изменено на УДАЛЁННЫЙ. Данная информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

deprecated

Необязательный маркер RFC3339, начиная с которого состояние ресурса должно быть изменено на УСТАРЕВШИЙ. Данная информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

obsolete

Необязательный маркер RFC3339, начиная с которого состояние ресурса должно быть изменено на ЗАМЕНЁННЫЙ. Данная информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

replacement

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

state

Статус устаревания ресурса. Может быть УСТАРЕВШИЙ, ЗАМЕНЁННЫЙ или УДАЛЁННЫЙ. Операции по созданию нового ресурса с использованием устаревшего ресурса будут выполнены успешно, но с предупреждением, указывающим на устаревший ресурс и рекомендующей замену. Операции с использованием ЗАМЕНЁННЫХ или УДАЛЁННЫХ ресурсов будут отклонены и приведут к ошибке.

Возможные значения:

• УСТАРЕВШИЙ
• ЗАМЕНЁННЫЙ
• УДАЛЁННЫЙ

description

Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.

disk_size_gb

Размер изображения при восстановлении на постоянный диск (в ГБ).

family

Название семейства изображений, к которому принадлежит это изображение. Вы можете создать диски, указав семейство изображений вместо имени конкретного изображения. Семейство изображений всегда возвращает последнее не устаревшее изображение. Название семейства изображений должно соответствовать RFC1035.

guest_os_features

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

type

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

Возможные значения:

• MULTI_IP_SUBNET
• SECURE_BOOT
• UEFI_COMPATIBLE
• VIRTIO_SCSI_MULTIQUEUE
• WINDOWS

id

Уникальный идентификатор ресурса. Этот идентификатор задаётся сервером.

image_encryption_key

Шифрование изображения с использованием предоставленного клиентом ключа шифрования. После шифрования изображения с использованием предоставленного клиентом ключа вы должны предоставить тот же ключ, если вы используете изображение позже (например, для создания диска из изображения).

raw_key

Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или дешифрования этого ресурса.

sha256

SHA-256 хеш ключа шифрования, предоставленного клиентом, закодированный в RFC 4648 base64, который защищает этот ресурс.

kms_key_name

(Только для бета-версии) Имя ключа шифрования, хранящегося в Google Cloud KMS.

labels

Метки, применяемые к этому изображению.

label_fingerprint

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

licenses

Любой применимый URI лицензии.

name

Имя ресурса; предоставляется клиентом при создании ресурса. Имя должно быть длиной от 1 до 63 символов и соответствовать RFC1035. То есть, имя должно быть длиной от 1 до 63 символов и соответствовать регулярному выражению [a-z]([-a-z0-9]*[a-z0-9])?, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.

raw_disk

Параметры сырого изображения диска.

container_type

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

Возможные значения:

• TAR

sha1_checksum

Необязательная контрольная сумма SHA1 изображения диска перед распаковкой. Предоставляется клиентом при создании изображения диска.

source

Полная ссылка на Google Cloud Storage, где хранится хранилище диска. Вы должны указать либо это свойство, либо свойство sourceDisk, но не оба.

source_disk

Исходный диск для создания этого изображения на его основе. Вы должны указать либо это свойство, либо свойство rawDisk.source, но не оба, чтобы создать изображение.

source_disk_encryption_key

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

raw_key

Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или дешифрования этого ресурса.

sha256

RFC 4648 base64 закодированный SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс.

kms_key_name

(Только для бета-версии) Имя ключа шифрования, хранящегося в Google Cloud KMS.

source_disk_id

Значение ID диска, используемого для создания этого изображения. Это значение может быть использовано для определения, было ли изображение взято с текущего или предыдущего экземпляра диска с данным именем.

source_type

Тип изображения, используемого для создания этого диска. По умолчанию и единственное значение — RAW.

Возможные значения:

• RAW

self_link

Ссылка на само изображение.

status

Состояние изображения. Может быть READY PENDING или FAILED.

Возможные значения:

• ГОТОВО
• ОЖИДАНИЕ
• НЕУДАЧА

Разрешения GCP

Убедитесь, что для текущего проекта включён API Compute Engine.