Ресурс google_compute_address

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

Синтаксис

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

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

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

Примеры

describe google_compute_address(project: 'chef-gcp-inspec', location: 'europe-west2', name: 'inspec-gcp-global-address') do
  it { should exist }
  its('address') { should eq '10.2.0.3' }
  its('address_type') { should eq 'INTERNAL' }
  its('user_count') { should eq 0 }
end

describe google_compute_address(project: 'chef-gcp-inspec', location: 'europe-west2', name: 'nonexistent') do
  it { should_not exist }
end

Проверка наличия IP-адреса GCP compute address

describe google_compute_address(project: 'chef-inspec-gcp', location: 'europe-west2', name: 'compute-address') do
  its('address_ip_exists')  { should be true }
end

Проверка, что адрес GCP compute находится в определенном состоянии

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

Проверка, что IP-адрес GCP compute address имеет ожидаемое количество пользователей

describe google_compute_address(project: 'chef-inspec-gcp', location: 'europe-west2', name: 'compute-address') do
  its('user_count') { should eq 1 }
end

Проверка, что у первого пользователя адреса GCP compute address есть ожидаемое имя ресурса

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

Свойства

Свойства, доступные для ресурса google_compute_address:

address

Статический внешний IP-адрес, представленный этим ресурсом. Поддерживается только IPv4. Адрес может быть указан только для типов адресов INTERNAL. IP-адрес должен находиться в указанной подсети, если таковая имеется.

address_type

Тип адреса для резервирования.

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

• INTERNAL
• EXTERNAL

creation_timestamp

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

description

Необязательное описание этого ресурса.

id

Уникальный идентификатор ресурса.

name

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

purpose

Цель этого ресурса, которая может быть одной из следующих: - GCE_ENDPOINT для адресов, используемых виртуальными машинами, диапазонами IP-адресов псевдонимов, внутренними балансировщиками и подобными ресурсами. Это значение должно устанавливаться только при использовании внутреннего адреса.

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

• GCE_ENDPOINT

network_tier

Сетевой уровень, используемый для настройки этого адреса. Если это поле не указано, предполагается, что это PREMIUM.

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

• PREMIUM
• STANDARD

subnetwork

URL подсети, в которой необходимо зарезервировать адрес. Если указан IP-адрес, он должен находиться в диапазоне IP-адресов подсети. Это поле может использоваться только с типом INTERNAL с целями GCE_ENDPOINT/DNS_RESOLVER.

users

URL-адреса ресурсов, использующих этот адрес.

labels

(Только для бета-версии) Метки, применяемые к этому адресу. Список пар ключ-значение.

label_fingerprint

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

status

Состояние адреса, которое может быть одним из следующих: RESERVING, RESERVED или IN_USE. Адрес, находящийся в состоянии RESERVING, в настоящее время резервируется. Адрес RESERVED в настоящее время зарезервирован и доступен для использования. Адрес IN_USE в настоящее время используется другим ресурсом и недоступен.

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

• RESERVING
• RESERVED
• IN_USE

region

URL региона, в котором находится региональный адрес. Это поле не применимо к глобальным адресам.

Разрешения GCP

Убедитесь, что API Compute Engine https://console.cloud.google.com/apis/library/compute.googleapis.com/ включен для текущего проекта.