google.cloud.gcp_compute_region_instance_group_manager 模块 – 创建一个 GCP RegionInstanceGroupManager

注意

此模块是 google.cloud 集合（版本 1.4.1）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install google.cloud。您需要进一步的要求才能使用此模块，请参阅 要求 以了解详细信息。

要在 playbook 中使用它，请指定：google.cloud.gcp_compute_region_instance_group_manager。

注意

由于违反了 Ansible 包含要求，google.cloud 集合将从 Ansible 12 中删除。该集合存在 未解决的健全性测试失败。有关更多信息，请参阅 讨论主题。

概要

• 使用您在请求中指定的信息创建一个托管实例组。创建组后，它会安排一个操作，使用指定的实例模板在该组中创建实例。即使组中的实例尚未创建，此操作也会在创建组时标记为 DONE。您必须单独验证各个实例的状态。

• 一个托管实例组每个组最多可以有 1000 个 VM 实例。

要求

执行此模块的主机需要以下要求。

• python >= 2.6

• requests >= 2.18.4

• google-auth >= 1.3.0

参数

参数	注释
access_token 字符串	如果凭据类型为 accesstoken，则为 OAuth2 访问令牌。
auth_kind 字符串 / 必需	使用的凭据类型。 选项 "application" "machineaccount" "serviceaccount" "accesstoken"
auto_healing_policies 列表 / 元素=字典	此托管实例组的自动修复策略。
health_check 字符串	表示自动修复的运行状况检查的 URL。
initial_delay_sec 整数	托管实例组在将自动修复策略应用于新实例或最近重新创建的实例之前等待的秒数。
base_instance_name 字符串 / 必需	用于此组中实例的基本实例名称。该值必须为 1-58 个字符长。实例的命名方式是在基本实例名称后附加一个连字符和一个随机的四字符字符串。 基本实例名称必须符合 RFC1035。
description 字符串	此资源的可选描述。创建资源时提供此属性。
env_type 字符串	指定您在此模块中运行的 Ansible 环境。 除非您知道自己在做什么，否则不应设置此项。 这只会更改任何 API 请求的用户代理字符串。
instance_template 字典 / 必需	为此托管实例组指定的实例模板。该组使用此模板在托管实例组中创建所有新实例。 此字段表示 GCP 中 InstanceTemplate 资源的链接。可以通过两种方式指定它。首先，您可以放置一个带有键“selfLink”和资源 selfLink 值的字典。或者，您可以将 `register: name-of-resource` 添加到 gcp_compute_instance_template 任务，然后将此 instance_template 字段设置为“{{ name-of-resource }}”
name 字符串 / 必需	托管实例组的名称。名称必须为 1-63 个字符长，并且符合 RFC1035。
named_ports 列表 / 元素=字典	为与此实例组管理器互补的实例组配置的命名端口。
name 字符串	此命名端口的名称。名称必须为 1-63 个字符长，并且符合 RFC1035。
port 整数	端口号，其值可以在 1 到 65535 之间。
project 字符串	要使用的 Google Cloud Platform 项目。
region 字符串 / 必需	托管实例组所在的区域。
scopes 列表 / 元素=字符串	要使用的作用域数组
service_account_contents jsonarg	服务帐户 JSON 文件的内容，可以是字典或表示它的 JSON 字符串。
service_account_email 字符串	如果选择了 machineaccount 且用户不希望使用默认电子邮件，则可选的服务帐户电子邮件地址。
service_account_file 路径	如果选择 serviceaccount 作为类型，则为服务帐户 JSON 文件的路径。
state 字符串	给定对象是否应存在于 GCP 中 选项 "present" ←（默认） "absent"
target_pools 列表 / 元素=字典	向其中添加实例组字段中的实例的 TargetPool 资源。目标池自动应用于托管实例组中的所有实例。
target_size 整数	此托管实例组的目标运行实例数。删除或放弃实例会减少此数字。调整组大小会更改此数字。

示例

- 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-central1
    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: "{{ resource_name }}"
    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: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"
    state: present
  register: instancetemplate

- name: create a region instance group manager
  google.cloud.gcp_compute_region_instance_group_manager:
    name: test_object
    base_instance_name: test1-child
    region: us-central1
    instance_template: "{{ instancetemplate }}"
    target_size: 3
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

返回值

常见的返回值已记录在 此处，以下是此模块特有的字段

键	描述
autoHealingPolicies 复杂	此托管实例组的自动修复策略。 返回：成功
healthCheck 字符串	表示自动修复的运行状况检查的 URL。 返回：成功
initialDelaySec 整数	托管实例组在将自动修复策略应用于新实例或最近重新创建的实例之前等待的秒数。 返回：成功
baseInstanceName 字符串	用于此组中实例的基本实例名称。该值必须为 1-58 个字符长。实例的命名方式是在基本实例名称后附加一个连字符和一个随机的四字符字符串。 基本实例名称必须符合 RFC1035。 返回：成功
creationTimestamp 字符串	此托管实例组的创建时间戳，采用 RFC3339 文本格式。 返回：成功
currentActions 复杂	实例操作列表以及此托管实例组中计划用于每个操作的实例数量。 返回：成功
abandoning 整数	托管实例组中计划放弃的实例总数。放弃实例会将其从托管实例组中删除，而不会将其删除。 返回：成功
creating 整数	托管实例组中计划创建或当前正在创建的实例数量。如果该组未能创建任何这些实例，它会重试直到成功创建该实例。 如果您禁用了创建重试，则不会填充此字段；而是填充 creatingWithoutRetries 字段。 返回：成功
creatingWithoutRetries 整数	托管实例组将尝试创建的实例数量。该组仅尝试创建每个实例一次。如果该组未能创建任何这些实例，它会相应地减小该组的 targetSize 值。 返回：成功
deleting 整数	托管实例组中计划删除或当前正在删除的实例数量。 返回：成功
无 整数	托管实例组中正在运行且没有计划操作的实例数量。 返回：成功
正在重新创建 整数	托管实例组中计划重新创建或当前正在重新创建的实例数量。 重新创建实例会删除现有的根持久磁盘，并根据实例模板中定义的映像创建一个新的磁盘。 返回：成功
正在刷新 整数	托管实例组中正在重新配置属性的实例数量，这些属性不需要重启或重新创建操作。 例如，为实例设置或删除目标池。 返回：成功
正在重启 整数	托管实例组中计划重启或当前正在重启的实例数量。 返回：成功
description 字符串	此资源的可选描述。创建资源时提供此属性。 返回：成功
id 整数	此资源的唯一标识符。 返回：成功
instanceGroup 字典	正在管理的实例组。 返回：成功
instanceTemplate 字典	为此托管实例组指定的实例模板。该组使用此模板在托管实例组中创建所有新实例。 返回：成功
name 字符串	托管实例组的名称。名称必须为 1-63 个字符长，并且符合 RFC1035。 返回：成功
namedPorts 复杂	为与此实例组管理器互补的实例组配置的命名端口。 返回：成功
name 字符串	此命名端口的名称。名称必须为 1-63 个字符长，并且符合 RFC1035。 返回：成功
port 整数	端口号，其值可以在 1 到 65535 之间。 返回：成功
region 字符串	托管实例组所在的区域。 返回：成功
targetPools 列表 / 元素=字符串	向其中添加实例组字段中的实例的 TargetPool 资源。目标池自动应用于托管实例组中的所有实例。 返回：成功
targetSize 整数	此托管实例组的目标运行实例数。删除或放弃实例会减少此数字。调整组大小会更改此数字。 返回：成功

作者

• Google Inc. (@googlecloudplatform)

集合链接

• 问题跟踪器
• 主页
• 存储库（源代码）