Ресурс google_compute_image

[править на GitHub]

Синтаксис

Для проверки ресурса изображения Google используется google_compute_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 находится в определенном состоянии, например, «READY» означает доступность для использования

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

Проверка, что изображение GCP compute имеет ожидаемую семейную принадлежность

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, после которой состояние этого ресурса предполагается изменить на DELETED. Эта информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

deprecated

Необязательная отметка времени RFC3339, после которой состояние этого ресурса предполагается изменить на DEPRECATED. Эта информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

obsolete

Необязательная отметка времени RFC3339, после которой состояние этого ресурса предполагается изменить на OBSOLETE. Эта информация носит информационный характер, и состояние не изменится, пока клиент явно не изменит его.

replacement

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

state

Состояние устаревания этого ресурса. Может быть DEPRECATED, OBSOLETE или DELETED. Операции, создающие новый ресурс с использованием устаревшего ресурса, будут выполнены успешно, но с предупреждением об устаревшем ресурсе и рекомендацией по его замене. Операции с использованием устаревших или удаленных ресурсов будут отклонены и приведут к ошибке.

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

• DEPRECATED
• OBSOLETE
• DELETED

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-битный предоставленный клиентом ключ шифрования, закодированный в формате base64 RFC 4648 для шифрования или дешифрования этого ресурса.

sha256

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

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-битный предоставленный клиентом ключ шифрования, закодированный в формате base64 RFC 4648 для шифрования или дешифрования этого ресурса.

sha256

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

kms_key_name

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

source_disk_id

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

source_type

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

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

• RAW

self_link

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

status

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

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

• READY
• PENDING
• FAILED

Разрешения GCP

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