Try SpotterCreate, start, stop, restart or terminate an instance in ECS, add or remove an instance to/from a security group
Authors: He Guimin (@xiaozhu36)
preview | supported by community
Install with ansible-galaxy collection install community.general:==0.1.1
collections:
- name: community.general
version: 0.1.1Create, start, stop, restart, modify or terminate ecs instances.
Add or remove ecs instances to/from security group.
# basic provisioning example vpc network
- name: basic provisioning example
hosts: localhost
vars:
alicloud_access_key: <your-alicloud-access-key-id>
alicloud_secret_key: <your-alicloud-access-secret-key>
alicloud_region: cn-beijing
image: ubuntu1404_64_40G_cloudinit_20160727.raw
instance_type: ecs.n4.small
vswitch_id: vsw-abcd1234
assign_public_ip: True
max_bandwidth_out: 10
host_name: myhost
password: mypassword
system_disk_category: cloud_efficiency
system_disk_size: 100
internet_charge_type: PayByBandwidth
security_groups: ["sg-f2rwnfh23r"]
instance_ids: ["i-abcd12346", "i-abcd12345"]
force: True
tasks:
- name: launch ECS instance in VPC network
ali_instance:
alicloud_access_key: '{{ alicloud_access_key }}'
alicloud_secret_key: '{{ alicloud_secret_key }}'
alicloud_region: '{{ alicloud_region }}'
image: '{{ image }}'
system_disk_category: '{{ system_disk_category }}'
system_disk_size: '{{ system_disk_size }}'
instance_type: '{{ instance_type }}'
vswitch_id: '{{ vswitch_id }}'
assign_public_ip: '{{ assign_public_ip }}'
internet_charge_type: '{{ internet_charge_type }}'
max_bandwidth_out: '{{ max_bandwidth_out }}'
instance_tags:
Name: created_one
host_name: '{{ host_name }}'
password: '{{ password }}'
- name: with count and count_tag to create a number of instances
ali_instance:
alicloud_access_key: '{{ alicloud_access_key }}'
alicloud_secret_key: '{{ alicloud_secret_key }}'
alicloud_region: '{{ alicloud_region }}'
image: '{{ image }}'
system_disk_category: '{{ system_disk_category }}'
system_disk_size: '{{ system_disk_size }}'
instance_type: '{{ instance_type }}'
assign_public_ip: '{{ assign_public_ip }}'
security_groups: '{{ security_groups }}'
internet_charge_type: '{{ internet_charge_type }}'
max_bandwidth_out: '{{ max_bandwidth_out }}'
instance_tags:
Name: created_one
Version: 0.1
count: 2
count_tag:
Name: created_one
host_name: '{{ host_name }}'
password: '{{ password }}'
- name: start instance
ali_instance:
alicloud_access_key: '{{ alicloud_access_key }}'
alicloud_secret_key: '{{ alicloud_secret_key }}'
alicloud_region: '{{ alicloud_region }}'
instance_ids: '{{ instance_ids }}'
state: 'running'
- name: reboot instance forcibly
ecs:
alicloud_access_key: '{{ alicloud_access_key }}'
alicloud_secret_key: '{{ alicloud_secret_key }}'
alicloud_region: '{{ alicloud_region }}'
instance_ids: '{{ instance_ids }}'
state: 'restarted'
force: '{{ force }}'
- name: Add instances to an security group
ecs:
alicloud_access_key: '{{ alicloud_access_key }}'
alicloud_secret_key: '{{ alicloud_secret_key }}'
alicloud_region: '{{ alicloud_region }}'
instance_ids: '{{ instance_ids }}'
security_groups: '{{ security_groups }}'
count:
default: 1
description:
- The number of the new instance.
- Indicates how many instances that match I(count_tag) should be running.
- Instances are either created or terminated based on this value.
type: int
force:
default: false
description:
- Whether the current operation needs to be execute forcibly.
type: bool
state:
choices:
- absent
- present
- restarted
- running
- stopped
default: present
description:
- The state of the instance after operating.
type: str
period:
default: 1
description:
- The charge duration of the instance, in month.
- Required when I(instance_charge_type=PrePaid).
- The valid value are [1-9, 12, 24, 36].
type: int
image_id:
aliases:
- image
description:
- Image ID used to launch instances.
- Required when I(state=present) and creating new ECS instances.
type: str
key_name:
aliases:
- keypair
description:
- The name of key pair which is used to access ECS instance in SSH.
required: false
type: str
password:
description:
- The password to login instance.
- After rebooting instances, modified password will take effect.
type: str
count_tag:
description:
- Determines how many instances based on a specific tag criteria should be present.
- This can be expressed in multiple ways and is shown in the EXAMPLES section.
- The specified count_tag must already exist or be passed in as the I(instance_tags)
option.
- If it is not specified, it will be replaced by I(instance_name).
type: str
host_name:
description:
- Instance host name.
type: str
user_data:
description:
- User-defined data to customize the startup behaviors of an ECS instance and to pass
data into an ECS instance. It only will take effect when launching the new ECS instances.
required: false
type: str
auto_renew:
default: false
description:
- Whether automate renew the charge of the instance.
type: bool
vswitch_id:
aliases:
- subnet_id
description:
- The subnet ID in which to launch the instances (VPC).
type: str
description:
description:
- The description of ECS instance, which is a string of 2 to 256 characters.
- It cannot begin with http:// or https://.
type: str
instance_ids:
description:
- A list of instance ids. It is required when need to operate existing instances.
- If it is specified, I(count) will lose efficacy.
type: list
instance_name:
aliases:
- name
description:
- The name of ECS instance, which is a string of 2 to 128 Chinese or English characters.
- It must begin with an uppercase/lowercase letter or a Chinese character and can
contain numerals, ".", "_" or "-". It cannot begin with http:// or https://.
type: str
instance_tags:
aliases:
- tags
description:
- A hash/dictionaries of instance tags, to add to the new instance or for starting/stopping
instance by tag (C({"key":"value"})).
type: dict
instance_type:
aliases:
- type
description:
- Instance type used to launch instances.
- Required when I(state=present) and creating new ECS instances.
type: str
alicloud_region:
aliases:
- region
- region_id
description:
- The Aliyun Cloud region to use.
- If not specified then the value of environment variable C(ALICLOUD_REGION), C(ALICLOUD_REGION_ID)
will be used instead.
type: str
security_groups:
description:
- A list of security group IDs.
type: list
max_bandwidth_in:
default: 200
description:
- Maximum incoming bandwidth from the public network, measured in Mbps (Megabits per
second).
type: int
system_disk_name:
description:
- Name of the system disk.
type: str
system_disk_size:
default: 40
description:
- Size of the system disk, in GB. The valid values are 40~500.
type: int
auto_renew_period:
choices:
- 1
- 2
- 3
- 6
- 12
description:
- The duration of the automatic renew the charge of the instance.
- Required when I(auto_renew=True).
type: int
availability_zone:
aliases:
- alicloud_zone
description:
- Aliyun availability zone ID in which to launch the instance.
- If it is not specified, it will be allocated by system automatically.
type: str
max_bandwidth_out:
default: 0
description:
- Maximum outgoing bandwidth to the public network, measured in Mbps (Megabits per
second).
type: int
allocate_public_ip:
aliases:
- assign_public_ip
default: false
description:
- Whether allocate a public ip for the new instance.
type: bool
alicloud_access_key:
aliases:
- access_key_id
- access_key
description:
- Aliyun Cloud access key.
- If not set then the value of environment variable C(ALICLOUD_ACCESS_KEY), C(ALICLOUD_ACCESS_KEY_ID)
will be used instead.
type: str
alicloud_secret_key:
aliases:
- secret_access_key
- secret_key
description:
- Aliyun Cloud secret key.
- If not set then the value of environment variable C(ALICLOUD_SECRET_KEY), C(ALICLOUD_SECRET_ACCESS_KEY)
will be used instead.
type: str
instance_charge_type:
choices:
- PrePaid
- PostPaid
default: PostPaid
description:
- The charge type of the instance.
type: str
internet_charge_type:
choices:
- PayByBandwidth
- PayByTraffic
default: PayByBandwidth
description:
- Internet charge type of ECS instance.
type: str
system_disk_category:
choices:
- cloud_efficiency
- cloud_ssd
default: cloud_efficiency
description:
- Category of the system disk.
type: str
alicloud_security_token:
aliases:
- security_token
description:
- The Aliyun Cloud security token.
- If not specified then the value of environment variable C(ALICLOUD_SECURITY_TOKEN)
will be used instead.
type: str
system_disk_description:
description:
- Description of the system disk.
type: str
ids:
description: List of ECS instance IDs.
returned: always
sample:
- i-12345er
- i-3245fs
type: list
instances:
contains:
availability_zone:
description: The availability zone of the instance is in.
returned: always
sample: cn-beijing-a
type: str
block_device_mappings:
contains:
attach_time:
description: The time stamp when the attachment initiated.
returned: always
sample: '2018-06-25T04:08:26Z'
type: str
delete_on_termination:
description: Indicates whether the volume is deleted on instance termination.
returned: always
sample: true
type: bool
device_name:
description: The device name exposed to the instance (for example, /dev/xvda).
returned: always
sample: /dev/xvda
type: str
status:
description: The attachment state.
returned: always
sample: in_use
type: str
volume_id:
description: The ID of the cloud disk.
returned: always
sample: d-2zei53pjsi117y6gf9t6
type: str
description: Any block device mapping entries for the instance.
returned: always
type: complex
cpu:
description: The CPU core count of the instance.
returned: always
sample: 4
type: int
creation_time:
description: The time the instance was created.
returned: always
sample: 2018-06-25T04:08Z
type: str
description:
description: The instance description.
returned: always
sample: my ansible instance
type: str
eip:
contains:
allocation_id:
description: The ID of the EIP.
returned: always
sample: eip-12345
type: str
internet_charge_type:
description: The internet charge type of the EIP.
returned: always
sample: paybybandwidth
type: str
ip_address:
description: EIP address.
returned: always
sample: 42.10.2.2
type: str
description: The attribution of EIP associated with the instance.
returned: always
type: complex
expired_time:
description: The time the instance will expire.
returned: always
sample: 2099-12-31T15:59Z
type: str
gpu:
contains:
amount:
description: The count of the GPU.
returned: always
sample: 0
type: int
spec:
description: The specification of the GPU.
returned: always
sample: ''
type: str
description: The attribution of instance GPU.
returned: always
type: complex
host_name:
description: The host name of the instance.
returned: always
sample: iZ2zewaoZ
type: str
id:
description: Alias of instance_id.
returned: always
sample: i-abc12345
type: str
image_id:
description: The ID of the image used to launch the instance.
returned: always
sample: m-0011223344
type: str
inner_ip_address:
description: The inner IPv4 address of the classic instance.
returned: always
sample: 10.0.0.2
type: str
instance_charge_type:
description: The instance charge type.
returned: always
sample: PostPaid
type: str
instance_id:
description: ECS instance resource ID.
returned: always
sample: i-abc12345
type: str
instance_name:
description: The name of the instance.
returned: always
sample: my-ecs
type: str
instance_type:
description: The instance type of the running instance.
returned: always
sample: ecs.sn1ne.xlarge
type: str
internet_charge_type:
description: The billing method of the network bandwidth.
returned: always
sample: PayByBandwidth
type: str
internet_max_bandwidth_in:
description: Maximum incoming bandwidth from the internet network.
returned: always
sample: 200
type: int
internet_max_bandwidth_out:
description: Maximum incoming bandwidth from the internet network.
returned: always
sample: 20
type: int
io_optimized:
description: Indicates whether the instance is optimized for EBS I/O.
returned: always
sample: false
type: bool
memory:
description: Memory size of the instance.
returned: always
sample: 8192
type: int
network_interfaces:
contains:
mac_address:
description: The MAC address.
returned: always
sample: 00:11:22:33:44:55
type: str
network_interface_id:
description: The ID of the network interface.
returned: always
sample: eni-01234567
type: str
primary_ip_address:
description: The primary IPv4 address of the network interface within the
vswitch.
returned: always
sample: 10.0.0.1
type: str
description: One or more network interfaces for the instance.
returned: always
type: complex
osname:
description: The operation system name of the instance owned.
returned: always
sample: CentOS
type: str
ostype:
description: The operation system type of the instance owned.
returned: always
sample: linux
type: str
private_ip_address:
description: The IPv4 address of the network interface within the subnet.
returned: always
sample: 10.0.0.1
type: str
public_ip_address:
description: The public IPv4 address assigned to the instance.
returned: always
sample: 43.0.0.1
type: str
resource_group_id:
description: The id of the resource group to which the instance belongs.
returned: always
sample: my-ecs-group
type: str
security_groups:
contains:
group_id:
description: The ID of the security group.
returned: always
sample: sg-0123456
type: str
group_name:
description: The name of the security group.
returned: always
sample: my-security-group
type: str
description: One or more security groups for the instance.
elements: dict
returned: always
type: list
status:
description: The current status of the instance.
returned: always
sample: running
type: str
tags:
description: Any tags assigned to the instance.
returned: always
sample: null
type: dict
vpc_id:
description: The ID of the VPC the instance is in.
returned: always
sample: vpc-0011223344
type: dict
vswitch_id:
description: The ID of the vswitch in which the instance is running.
returned: always
sample: vsw-dew00abcdef
type: str
description: List of ECS instances.
returned: always
type: complex