google.cloud.gcp_compute_instance_template – Создаёт шаблон виртуальной машины GCP
Примечание
Этот плагин входит в сборку google.cloud (версия 1.0.2).
Для его установки используйте: ansible-galaxy collection install google.cloud.
Для использования в плейбуке укажите: google.cloud.gcp_compute_instance_template.
Обзор
- Определяет ресурс шаблона виртуальной машины, который предоставляет параметры конфигурации для ваших виртуальных машин. Шаблоны виртуальных машин не привязаны к жизненному циклу экземпляра и могут использоваться и повторно использоваться для развертывания виртуальных машин. Вы также можете использовать разные шаблоны для создания различных конфигураций виртуальных машин. Шаблоны виртуальных машин требуются при создании группы виртуальных машин.
- Подсказка: Диски должны быть установлены с autoDelete=true, чтобы предотвратить оставление лишних дисков после удаления машины.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется данный модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||||
|---|---|---|---|---|---|---|
| auth_kind строка / обязательно |
| Тип используемых учетных данных. | ||||
| description строка | Необязательное описание этого ресурса. Укажите это свойство при создании ресурса. | |||||
| env_type строка | Указывает, в какой среде Ansible выполняется этот модуль. Не следует устанавливать, если вы не знаете, что делаете. Это изменяет только строку User Agent для всех запросов к API. | |||||
| name строка / обязательно | Имя ресурса. Длина имени составляет от 1 до 63 символов и соответствует RFC1035. | |||||
| project строка | Проект Google Cloud Platform, который следует использовать. | |||||
| properties словарь | Свойства виртуальной машины для этой модели виртуальной машины. | |||||
| can_ip_forward булево |
| Разрешает экземплярам, созданным на основе этой модели, отправлять пакеты с исходными IP-адресами, отличными от их собственных, и получать пакеты с целевыми IP-адресами, отличными от их собственных. Если эти экземпляры будут использоваться в качестве шлюза IP или будут установлены в качестве следующего узла в ресурсе маршрутизации, укажите true. Если вы не уверены, оставьте это значение false. | ||||
| description строка | Необязательное текстовое описание экземпляров, которые создаются из этой модели экземпляра. | |||||
| disks список / элементы=словарь | Массив дисков, связанных с экземплярами, созданными из этой модели. | |||||
| auto_delete булево |
| Указывает, будет ли диск автоматически удален при удалении экземпляра (но не при отделении диска от экземпляра). Совет: Диски должны быть настроены на autoDelete=true, чтобы избежать оставления лишних дисков при удалении машины. | ||||
| boot булево |
| Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для своей корневой файловой системы. | ||||
| device_name строка | Указывает уникальное имя устройства по вашему выбору, отражаемое в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей внутри экземпляра. Это имя может использоваться для ссылки на устройство для монтирования, изменения размера и т. д. внутри экземпляра. | |||||
| disk_encryption_key словарь | Шифрует или расшифровывает диск с помощью предоставленного пользователем ключа шифрования. | |||||
| raw_key строка | Указывает 256-битный ключ шифрования, предоставленный пользователем, закодированный в формате base64 RFC 4648 для шифрования или расшифрования этого ресурса. | |||||
| rsa_encrypted_key строка | Указывает закодированный в формате base64 RFC 4648, обернутый RSA, 2048-битный ключ шифрования, предоставленный пользователем, для шифрования или расшифрования этого ресурса. | |||||
| index целое число | Присваивает индекс с нулевым основанием этому диску, где 0 зарезервирован для загрузочного диска. Например, если к экземпляру подключено много дисков, каждый диск будет иметь уникальный номер индекса. Если не указано, сервер выберет соответствующее значение. | |||||
| initialize_params словарь | Устанавливает параметры для нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных твердотельных накопителей, подключенных к новому экземпляру. | |||||
| disk_name строка | Указывает имя диска. Если не указано, используется имя экземпляра по умолчанию. | |||||
| disk_size_gb целое число | Указывает размер диска в гигабайтах (основание 2). | |||||
| disk_type строка | Ссылка на тип диска. Указывает тип диска для создания экземпляра. Если не указано, используется значение по умолчанию pd-standard. | |||||
| source_image строка | Исходный образ для создания этого диска. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. Для создания диска с одним из общедоступных образов операционных систем укажите имя семейства образа. | |||||
| source_image_encryption_key словарь | Ключ шифрования, предоставленный пользователем, для исходного образа. Требуется, если исходный образ защищен ключом шифрования, предоставленным пользователем. Шаблоны экземпляров не хранят ключи шифрования, предоставленные пользователем, поэтому вы не можете создавать диски для экземпляров в группе управляемых экземпляров, если исходные образы зашифрованы вашими ключами. | |||||
| raw_key строка | Указывает 256-битный ключ шифрования, предоставленный пользователем, закодированный в формате base64 RFC 4648 для шифрования или расшифрования этого ресурса. | |||||
| interface строка | Указывает интерфейс диска для подключения этого диска, который может быть SCSI или NVME. По умолчанию используется SCSI. Постоянные диски всегда должны использовать SCSI, и запрос завершится ошибкой, если вы попытаетесь подключить постоянный диск в любом другом формате, кроме SCSI. Некоторые допустимые варианты включают: "SCSI", "NVME" | |||||
| mode строка | Режим подключения этого диска, либо READ_WRITE, либо READ_ONLY. Если не указано, по умолчанию диск подключается в режиме READ_WRITE. Некоторые допустимые варианты включают: "READ_WRITE", "READ_ONLY" | |||||
| source словарь | Ссылка на диск. При создании нового экземпляра требуется один из initializeParams.sourceImage или disks.source. По желанию, вы также можете подключить существующие постоянные диски, не являющиеся корневыми, используя это свойство. Это поле применимо только к постоянным дискам. Обратите внимание, что для InstanceTemplate укажите имя диска, а не URL-адрес диска. Это поле представляет собой ссылку на ресурс Disk в GCP. Его можно указать двумя способами. Во-первых, вы можете поместить словарь с ключом 'name' и значением имени вашего ресурса. Во-вторых, вы можете добавить `register: name-of-resource` к задаче gcp_compute_disk и затем установить это поле source в "{{ name-of-resource }}" | |||||
| type строка | Указывает тип диска, либо SCRATCH, либо PERSISTENT. Если не указано, по умолчанию используется PERSISTENT. Некоторые допустимые варианты включают: "SCRATCH", "PERSISTENT" | |||||
| guest_accelerators список / элементы=словарь | Список типов и количества адаптеров ускорителей, подключенных к экземпляру. | |||||
| accelerator_count целое число | Количество адаптеров ускорителей гостевой ОС, доступных для этого экземпляра. | |||||
| accelerator_type строка | Полный или частичный URL-адрес ресурса типа ускорителя, доступного для этого экземпляра. | |||||
| labels словарь | Метки, применяемые к этому адресу. Список пар ключ-значение. | |||||
| machine_type строка / обязательно | Тип виртуальной машины для использования в шаблоне экземпляра виртуальной машины. | |||||
| metadata словарь | Ключевые пары метаданных, которые следует назначить экземплярам, созданным из этого шаблона. Эти пары могут состоять из пользовательских метаданных или предопределенных ключей. | |||||
| min_cpu_platform string | Указывает минимальную платформу процессора для виртуальной машины. Допустимые значения — понятные имена платформ процессоров. | |||||
| network_interfaces list / elements=dictionary | Массив конфигураций для этого интерфейса. Он определяет, как этот интерфейс взаимодействует с другими сетевыми службами, например, как подключается к интернету. На один экземпляр поддерживается только один сетевой интерфейс. | |||||
| access_configs list / elements=dictionary | Массив конфигураций для этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа ONE_TO_ONE_NAT. Если accessConfigs не указаны, у этого экземпляра не будет внешнего доступа к интернету. | |||||
| name string / required | Имя этой конфигурации доступа. По умолчанию и рекомендуется использовать имя External NAT, но вы можете использовать любую произвольную строку. Например, My external IP или Network Access. | |||||
| nat_ip dictionary | Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите неиспользуемый статический внешний IP-адрес, доступный для проекта, или оставьте это поле неопределенным, чтобы использовать IP из общего пула временных IP-адресов. Если вы указываете статический внешний IP-адрес, он должен находиться в той же области, что и зона экземпляра. Это поле представляет ссылку на ресурс Address в GCP. Его можно указать двумя способами. Во-первых, вы можете поместить словарь с ключом 'address' и значением адреса вашего ресурса. Во-вторых, вы можете добавить `register: name-of-resource` в задачу gcp_compute_address и затем установить это поле nat_ip в "{{ name-of-resource }}" | |||||
| network_tier string | Это означает уровень сети, используемый для настройки этой конфигурации доступа. Если AccessConfig указан без действительного внешнего IP-адреса, будет создан временный IP-адрес с этим networkTier. Если AccessConfig с действительным внешним IP-адресом указан, он должен совпадать с networkTier, связанным с ресурсом Address, владеющим этим IP-адресом. Некоторые допустимые варианты включают: "PREMIUM", "STANDARD" | |||||
| public_ptr_domain_name string | Имя домена DNS для записи PTR для общедоступных записей. Вы можете установить это поле только в том случае, если включено поле setPublicPtr. | |||||
| set_public_ptr boolean |
| Указывает, следует ли создавать запись DNS PTR для общедоступного домена для сопоставления внешнего IP-адреса экземпляра с именем домена DNS. | ||||
| type string / required | Тип конфигурации. По умолчанию и единственный вариант — ONE_TO_ONE_NAT. Некоторые допустимые варианты включают: "ONE_TO_ONE_NAT" | |||||
| alias_ip_ranges list / elements=dictionary | Массив диапазонов IP-адресов псевдонимов для этого сетевого интерфейса. Может быть указан только для сетевых интерфейсов на сетях в режиме подсети. | |||||
| ip_cidr_range string | Диапазон IP CIDR, представленный этим диапазоном псевдонима IP. Этот диапазон IP CIDR должен принадлежать указанной подсети и не может содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Этот диапазон может быть одним IP-адресом (например, 10.2.3.4), маской (например, /24) или строкой в формате CIDR (например, 10.1.2.0/24). | |||||
| subnetwork_range_name string | Необязательное имя вторичного диапазона подсети, указывающее вторичный диапазон, из которого следует выделять диапазон IP CIDR для этого диапазона псевдонимов IP. Если не указано, будет использоваться основной диапазон подсети. | |||||
| network dictionary | Указывает заголовок существующей сети. При создании экземпляра, если сеть или подсеть не указаны, используется сеть по умолчанию global/networks/default; если сеть не указана, но подсеть указана, сеть определяется по умолчанию. Это поле представляет ссылку на ресурс Network в GCP. Его можно указать двумя способами. Во-первых, вы можете поместить словарь с ключом 'selfLink' и значением selfLink вашего ресурса. Во-вторых, вы можете добавить `register: name-of-resource` в задачу gcp_compute_network и затем установить это поле network в "{{ name-of-resource }}" | |||||
| network_ip string | Внутренний IPv4-адрес сети, который следует назначить экземпляру для этого сетевого интерфейса. Если пользователь не указывает, система назначает неиспользуемый внутренний IP-адрес. | |||||
| subnetwork dictionary | Ссылка на сеть VPC. Если сетевой ресурс находится в режиме legacy, не указывайте это свойство. Если сеть находится в режиме автоматической подсети, предоставление подсети является необязательным. Если сеть находится в режиме пользовательской подсети, это поле должно быть указано. Это поле представляет ссылку на ресурс Subnetwork в GCP. Его можно указать двумя способами. Во-первых, вы можете поместить словарь с ключом 'selfLink' и значением selfLink вашего ресурса. Во-вторых, вы можете добавить `register: name-of-resource` в задачу gcp_compute_subnetwork и затем установить это поле subnetwork в "{{ name-of-resource }}" | |||||
| scheduling dictionary | Устанавливает параметры планирования для этого экземпляра. | |||||
| automatic_restart boolean |
| Указывает, следует ли автоматически перезапускать экземпляр, если он был завершен Compute Engine (но не пользователем). Вы можете установить опцию автоматического перезапуска только для стандартных экземпляров. Зарезервированные экземпляры не могут быть автоматически перезапущены. | ||||
| on_host_maintenance string | Определяет поведение технического обслуживания для этого экземпляра. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для зарезервированных экземпляров поведение по умолчанию и единственно возможное — TERMINATE. Для получения дополнительной информации см. Настройка параметров планирования экземпляров. | |||||
| preemptible boolean |
| Определяет, является ли экземпляр резервируемым. Это можно задать только при создании экземпляра, изменить его после создания экземпляра нельзя. | ||||
| service_accounts list / elements=dictionary | Список учетных записей сервисов с их указанными областями, авторизованными для этого экземпляра. На один экземпляр виртуальной машины поддерживается только одна учетная запись сервиса. | |||||
| email string | Электронный адрес учетной записи сервиса. | |||||
| scopes list / elements=string | Список областей, которые должны быть доступны для этой учетной записи сервиса. | |||||
| tags dictionary | Список тегов для применения к этому экземпляру. Теги используются для определения допустимых источников или целей для сетевых брандмауэров и указываются клиентом при создании экземпляра. Теги могут быть изменены позже методом setTags. Каждый тег в списке должен соответствовать RFC1035. | |||||
| fingerprint string | Указывает отпечаток для этого запроса, который представляет собой хэш содержимого метаданных и используется для оптимистической блокировки. Отпечаток первоначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны предоставлять актуальный хэш отпечатка, чтобы обновить или изменить метаданные. | |||||
| items list / elements=string | Массив тегов. Каждый тег должен иметь длину от 1 до 63 символов и соответствовать RFC1035. | |||||
| scopes list / elements=string | Массив областей, которые следует использовать | |||||
| service_account_contents jsonarg | Содержимое файла JSON учетной записи сервиса, либо в виде словаря, либо как строка JSON, которая его представляет. | |||||
| service_account_email string | Дополнительный адрес электронной почты учетной записи сервиса, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию. | |||||
| service_account_file path | Путь к файлу JSON учетной записи сервиса, если выбран тип serviceaccount. | |||||
| state string |
| Указывает, должен ли данный объект существовать в GCP | ||||
Примеры
- name: create a network
google.cloud.gcp_compute_network:
name: network-instancetemplate
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: network
- name: create a address
google.cloud.gcp_compute_address:
name: address-instancetemplate
region: us-west1
project: "{{ gcp_project }}"
auth_kind: "{{ gcp_cred_kind }}"
service_account_file: "{{ gcp_cred_file }}"
state: present
register: address
- name: create a instance template
google.cloud.gcp_compute_instance_template:
name: test_object
properties:
disks:
- auto_delete: 'true'
boot: 'true'
initialize_params:
source_image: projects/ubuntu-os-cloud/global/images/family/ubuntu-1604-lts
machine_type: n1-standard-1
network_interfaces:
- network: "{{ network }}"
access_configs:
- name: test-config
type: ONE_TO_ONE_NAT
nat_ip: "{{ address }}"
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
state: present
Значения возврата
Общие значения возврата описаны здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание | ||||
|---|---|---|---|---|---|---|
| creationTimestamp string | success | Марка времени создания в формате RFC3339. | ||||
| description string | success | Необязательное описание данного ресурса. Укажите это свойство при создании ресурса. | ||||
| id integer | success | Уникальный идентификатор ресурса. Этот идентификатор задаётся сервером. | ||||
| name string | success | Имя ресурса. Длина имени составляет от 1 до 63 символов и соответствует RFC1035. | ||||
| properties complex | success | Свойства экземпляра для этой шаблона экземпляра. | ||||
| canIpForward boolean | success | Разрешает экземплярам, созданным на основе этого шаблона, отправлять пакеты с адресами источника, отличными от их собственного, и получать пакеты с адресами назначения, отличными от их собственного. Если эти экземпляры будут использоваться в качестве IP-шлюза или будут заданы в качестве следующего узла в ресурсе маршрута, укажите true. В противном случае оставьте значение false. | ||||
| description string | success | Необязательное текстовое описание для экземпляров, созданных из этого шаблона экземпляра. | ||||
| disks complex | success | Массив дисков, связанных с экземплярами, созданными по этому шаблону. | ||||
| autoDelete boolean | success | Указывает, будет ли диск автоматически удалён при удалении экземпляра (но не при отсоединении диска от экземпляра). Совет: Диски должны быть установлены с autoDelete=true, чтобы избежать оставления ненужных дисков после удаления машины. | ||||
| boot boolean | success | Указывает, что это загрузочный диск. Виртуальная машина будет использовать первый раздел диска для своей файловой системы корня. | ||||
| deviceName string | success | Указывает уникальное имя устройства по вашему выбору, которое отражается в дереве /dev/disk/by-id/google-* операционной системы Linux, работающей внутри экземпляра. Это имя может быть использовано для ссылки на устройство для монтирования, изменения размера и т. д. изнутри экземпляра. | ||||
| diskEncryptionKey complex | success | Шифрует или расшифровывает диск с помощью предоставленного клиентом ключа шифрования. | ||||
| rawKey string | success | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или расшифровки данного ресурса. | ||||
| rsaEncryptedKey string | success | Указывает закодированный в RFC 4648 base64 ключ шифрования, обернутый RSA 2048-бит, предоставленный клиентом, для шифрования или расшифровки этого ресурса. | ||||
| sha256 string | success | Закодированный в RFC 4648 base64 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает данный ресурс. | ||||
| index integer | success | Назначает индекс с нулевой базой этому диску, где 0 зарезервирован для загрузочного диска. Например, если к экземпляру подключено много дисков, каждый диск будет иметь уникальный индекс. Если не указано, сервер выберет соответствующее значение. | ||||
| initializeParams complex | success | Указывает параметры для нового диска, который будет создан вместе с новым экземпляром. Используйте параметры инициализации для создания загрузочных дисков или локальных SSD, подключенных к новому экземпляру. | ||||
| diskName string | success | Указывает имя диска. Если не указано, используется имя экземпляра по умолчанию. | ||||
| diskSizeGb integer | success | Указывает размер диска в ГБ (в двоичной системе). | ||||
| diskType string | success | Ссылка на тип диска. Указывает тип диска для использования при создании экземпляра. Если не указано, используется pd-standard по умолчанию. | ||||
| sourceImage string | success | Источник образа для создания этого диска. При создании нового экземпляра требуется либо initializeParams.sourceImage, либо disks.source. Для создания диска с одним из общедоступных образов операционной системы укажите имя семейства образа. | ||||
| sourceImageEncryptionKey complex | success | Ключ шифрования источника образа, предоставленный клиентом. Требуется, если исходный образ защищён предоставленным клиентом ключом шифрования. Шаблоны экземпляров не хранят ключи шифрования, предоставленные клиентом, поэтому вы не можете создать диски для экземпляров в управляемой группе экземпляров, если исходные образы зашифрованы собственными ключами. | ||||
| rawKey string | success | Указывает 256-битный ключ шифрования, предоставленный клиентом, закодированный в RFC 4648 base64 для шифрования или расшифровки этого ресурса. | ||||
| sha256 string | success | Закодированный в RFC 4648 base64 SHA-256 хэш ключа шифрования, предоставленного клиентом, который защищает этот ресурс. | ||||
| interface string | success | Указывает интерфейс диска для подключения, SCSI или NVME. По умолчанию используется SCSI. Постоянные диски всегда должны использовать SCSI, и запрос будет неудачным, если вы попытаетесь подключить постоянный диск в любом другом формате, кроме SCSI. | ||||
| licenses list / elements=string | success | Любой применимый URI лицензии. | ||||
| mode string | success | Режим подключения диска, READ_WRITE или READ_ONLY. Если не указано, по умолчанию диск подключается в режиме READ_WRITE. | ||||
| source dictionary | success | Ссылка на диск. При создании нового экземпляра требуется либо initializeParams.sourceImage, либо disks.source. Если необходимо, вы также можете подключить существующие постоянные диски, не являющиеся корневыми, используя это свойство. Это поле применимо только для постоянных дисков. Обратите внимание, что для InstanceTemplate укажите имя диска, а не URL диска. | ||||
| type string | success | Указывает тип диска, SCRATCH или PERSISTENT. Если не указано, по умолчанию используется PERSISTENT. | ||||
| guestAccelerators complex | success | Список типов и количества ускорителей, подключенных к экземпляру. | ||||
| acceleratorCount integer | success | Количество ускорителей гостевой системы, предоставленных этому экземпляру. | ||||
| acceleratorType string | success | Полный или частичный URL ресурса типа ускорителя, предоставляемого этому экземпляру. | ||||
| labels dictionary | success | Метки, применяемые к этому адресу. Список пар ключ-значение. | ||||
| machineType string | success | Тип машины, используемый в шаблоне виртуального экземпляра. | ||||
| метаданные словарь | успех | Пара ключи/значения метаданных, которые нужно назначить экземплярам, созданным по этому шаблону. Эти пары могут содержать пользовательские метаданные или предопределенные ключи. | ||||
| minCpuPlatform строка | успех | Указывает минимальную платформу процессора для виртуальной машины. Допустимые значения — понятные имена платформ процессоров. | ||||
| networkInterfaces сложное | успех | Массив конфигураций для этого интерфейса. Он определяет, как этот интерфейс взаимодействует с другими сетевыми службами, например, подключением к интернету. На каждый экземпляр поддерживается только один сетевой интерфейс. | ||||
| accessConfigs сложное | успех | Массив конфигураций для этого интерфейса. В настоящее время поддерживается только одна конфигурация доступа ONE_TO_ONE_NAT. Если accessConfigs не указаны, этому экземпляру не будет доступен внешний интернет. | ||||
| name строка | успех | Название этой конфигурации доступа. По умолчанию и рекомендуется использовать имя External NAT, но вы можете использовать любую произвольную строку. Например, My external IP или Network Access. | ||||
| natIP словарь | успех | Ссылка на адрес. Внешний IP-адрес, связанный с этим экземпляром. Укажите свободный статический внешний IP-адрес, доступный для проекта, или оставьте это поле неопределённым, чтобы использовать IP из общего пула временных IP-адресов. Если вы указываете статический внешний IP-адрес, он должен находиться в той же области, что и зона экземпляра. | ||||
| networkTier строка | успех | Это указывает уровень сети, используемый для конфигурации этой конфигурации доступа. Если AccessConfig указан без действительного внешнего IP-адреса, будет создан временный IP с этим networkTier. Если AccessConfig с действительным внешним IP-адресом указан, он должен соответствовать networkTier, связанному с ресурсом Address, владеющим этим IP. | ||||
| publicPtrDomainName строка | успех | Доменное имя DNS для записи PTR для общедоступных записей. Вы можете задать это поле только если включено поле setPublicPtr. | ||||
| setPublicPtr булево | успех | Указывает, следует ли создавать общедоступную запись DNS PTR для сопоставления внешнего IP-адреса экземпляра с доменным именем. | ||||
| type строка | успех | Тип конфигурации. По умолчанию и единственный вариант — ONE_TO_ONE_NAT. | ||||
| aliasIpRanges сложное | успех | Массив диапазонов IP-адресов alias для этого сетевого интерфейса. Может быть указан только для сетевых интерфейсов в сетях subnet-mode. | ||||
| ipCidrRange строка | успех | Диапазон IP CIDR, представленный этим диапазоном IP-адресов alias. Этот диапазон IP CIDR должен принадлежать указанной подсети и не должен содержать IP-адреса, зарезервированные системой или используемые другими сетевыми интерфейсами. Этот диапазон может быть единственным IP-адресом (например, 10.2.3.4), маской (например, /24) или строкой в формате CIDR (например, 10.1.2.0/24). | ||||
| subnetworkRangeName строка | успех | Необязательное имя вторичного диапазона подсети, указывающее вторичный диапазон, из которого следует выделять диапазон IP CIDR для этого диапазона IP-адресов alias. Если не указано, будет использован основной диапазон подсети. | ||||
| name строка | успех | Имя сетевого интерфейса, сгенерированное сервером. Для сетевых устройств это eth0, eth1 и т. д. | ||||
| network словарь | успех | Указывает заголовок существующей сети. При создании экземпляра, если не указана ни сеть, ни подсеть, используется сеть по умолчанию global/networks/default; если сеть не указана, но указана подсеть, сеть определяется неявно. | ||||
| networkIP строка | успех | Внутренний IPv4-адрес сети для назначения экземпляру для этого сетевого интерфейса. Если пользователь не указывает, система назначает неиспользуемый внутренний IP. | ||||
| subnetwork словарь | успех | Ссылка на VPC-сеть. Если ресурс сети находится в режиме «legacy», не предоставляйте это свойство. Если сеть находится в режиме автоматической подсети, предоставление подсети является необязательным. Если сеть находится в режиме пользовательской подсети, это поле должно быть указано. | ||||
| scheduling сложное | успех | Устанавливает параметры планирования для этого экземпляра. | ||||
| automaticRestart булево | успех | Указывает, должен ли экземпляр автоматически перезапускаться, если он был завершён Compute Engine (не пользователем). Вы можете задать параметр автоматического перезапуска только для стандартных экземпляров. Для предварительно назначенных экземпляров автоматический перезапуск невозможен. | ||||
| onHostMaintenance строка | успех | Определяет поведение при обслуживании узла для этого экземпляра. Для стандартных экземпляров поведение по умолчанию — MIGRATE. Для предварительно назначенных экземпляров поведение по умолчанию и единственно возможное — TERMINATE. Для получения дополнительной информации см. Настройка параметров планирования экземпляров. | ||||
| preemptible булево | успех | Определяет, является ли экземпляр предварительно назначенным. Это можно задать только во время создания экземпляра, изменить после создания нельзя. | ||||
| serviceAccounts сложное | успех | Список учётных записей сервисов со своими указанными областями видимости, авторизованных для этого экземпляра. Только одна учётная запись сервиса поддерживается на один экземпляр виртуальной машины. | ||||
| email строка | успех | Адрес электронной почты учётной записи сервиса. | ||||
| scopes список / элементы=строка | успех | Список областей видимости, которые должны быть доступны для этой учётной записи сервиса. | ||||
| tags сложное | успех | Список тегов для применения к этому экземпляру. Теги используются для идентификации допустимых источников или целей для сетевых брандмауэров и указываются клиентом при создании экземпляра. Теги можно позже изменить методом setTags. Каждый тег в списке должен соответствовать RFC1035. | ||||
| fingerprint строка | успех | Указывает отпечаток для этого запроса, который по сути является хэшем содержимого метаданных и используется для оптимистической блокировки. Отпечаток изначально генерируется Compute Engine и изменяется после каждого запроса на изменение или обновление метаданных. Вы всегда должны предоставить актуальный хэш отпечатка, чтобы обновить или изменить метаданные. | ||||
| items список / элементы=строка | успех | Массив тегов. Каждый тег должен иметь длину от 1 до 63 символов и соответствовать RFC1035. | ||||
Авторы
- Google Inc. (@googlecloudplatform)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/google/cloud/gcp_compute_instance_template_module.html