ansible-alicloud

Ansible provider for Alicloud.


License
MIT
Install
pip install ansible-alicloud==1.13.0

Documentation

Ansible ECS Module

Ansible Alicloud Module is a new ansible module, and you can manage Alicloud ECS and other services more flexibly and conveniently via it. Next to introduce simply this module.

lib/ansible/modules/cloud/alicloud

There are several files in the module directory, and these files describe some function that can operate alicloud products.

  • ali_instance.py: Create, Start, Stop, Restart or Terminate an Instance in ECS. Add or Remove Instance to/from a Security Group
  • ali_disk.py: Create, Attach, Detach or Delete a disk in ECS
  • ali_security_group.py: Create or Delete a Security Group
  • ali_vpc.py: Create or Delete a Vpc.
  • ali_vswitch.py: Create or Delete a VSwitch.
  • ali_route_entry.py: Create or Delete a route entry.
  • ali_slb_lb.py: Create or Delete a Load balancer.
  • ali_slb_listener.py: Create or Delete a listener for one Load balancer.
  • ali_slb_server.py: Add or Remove backend server to/from Load balancer.
  • ali_ess_group.py: Create or Delete a scaling group.
  • ali_ess_configuration.py: Create or Delete a scaling configuration.
  • ali_ess_instance.py: Add or Remove ECS instnaces in a specified scaling group.
  • ali_ess_task.py: Create or Delete a scheduled task for scaling activity.
  • ali_ess_rule.py: Create or Delete a scaling rule.
  • ali_eni.py: Create or Delete a network interface.
  • ali_bucket.py: Create or Delete an OSS bucket.
  • ali_bucket_object.py: Upload or Download an object to/from an OSS bucket.

lib/ansible/module_utils

In the module utils directory, the file alicloud_ecs.py identifies and gains playbook params, and provides this params to modules/*.py. In addition, this file implements connection between ansible and Alicloud API via footmark.

examples

There are some playbooks to create some alicloud resource or build infrastructure architecture.

Install

There are two ways to install alicloud provider. However, before installing it. you should ensure Ansible has existed in your server. If not, please install it using the following command:

sudo pip install ansible
  • First one

    Ansible provider has been released, and you can install it easily using the following command:

    sudo pip install ansible_alicloud
    
  • Second one

    Ansible provider's modules support to install independently. That means you can download one or more modules from lib/ansible/modules/cloud/alicloud and then run them independently. However, before running them, you should ensure ansible_alicloud_module_utils has existed in your server. If not, please install it using the following command:

    sudo pip install ansible_alicloud_module_utils
    

Execute playbook

  • Input your alicloud access key in the playbook or set environment variable:ALICLOUD_ACCESS_KEY and ALICLOUD_SECRET_KEY).

  • Input others resource params in the playbook.

  • execute ansible-playbook command as follows:

    $ ansible-playbook xxx.yml
    

Refrence

Ansible Document: https://docs.ansible.com/ansible/latest/

Ansible Alicloud: Docs Details