このページについて
自作のクローラで自動生成した、Ansible 2.0 の新モジュール、新オプション一覧です。
Gist でも同じ内容を公開していますが、Qiita の目次機能があったほうが見やすそうなので、こちらにも貼っておきます。今回使ったクローラの詳細は、はてなブログの Ansible 2.0 で追加されたモジュールおよびオプション一覧を無理矢理作る - 無印吉澤 をご参照ください。
Modules added in version 2.0
Cloud Modules
- clc_aa_policy (E) - Create or Delete Anti Affinity Policies at CenturyLink Cloud.
- clc_alert_policy (E) - Create or Delete Alert Policies at CenturyLink Cloud.
- clc_blueprint_package (E) - deploys a blue print package on a set of servers in CenturyLink Cloud.
- clc_firewall_policy (E) - Create/delete/update firewall policies
- clc_group (E) - Create/delete Server Groups at Centurylink Cloud
- clc_loadbalancer (E) - Create, Delete shared loadbalancers in CenturyLink Cloud.
- clc_modify_server (E) - modify servers in CenturyLink Cloud.
- clc_publicip (E) - Add and Delete public ips on servers in CenturyLink Cloud.
- clc_server (E) - Create, Delete, Start and Stop servers in CenturyLink Cloud.
- clc_server_snapshot (E) - Create, Delete and Restore server snapshots in CenturyLink Cloud.
- cloudtrail (E) - manage CloudTrail creation and deletion
- cs_account (E) - Manages accounts on Apache CloudStack based clouds.
- cs_affinitygroup (E) - Manages affinity groups on Apache CloudStack based clouds.
- cs_domain (E) - Manages domains on Apache CloudStack based clouds.
- cs_facts (E) - Gather facts on instances of Apache CloudStack based clouds.
- cs_firewall (E) - Manages firewall rules on Apache CloudStack based clouds.
- cs_instance (E) - Manages instances and virtual machines on Apache CloudStack based clouds.
- cs_instancegroup (E) - Manages instance groups on Apache CloudStack based clouds.
- cs_ip_address (E) - Manages public IP address associations on Apache CloudStack based clouds.
- cs_iso (E) - Manages ISO images on Apache CloudStack based clouds.
- cs_loadbalancer_rule (E) - Manages load balancer rules on Apache CloudStack based clouds.
- cs_loadbalancer_rule_member (E) - Manages load balancer rule members on Apache CloudStack based clouds.
- cs_network (E) - Manages networks on Apache CloudStack based clouds.
- cs_portforward (E) - Manages port forwarding rules on Apache CloudStack based clouds.
- cs_project (E) - Manages projects on Apache CloudStack based clouds.
- cs_securitygroup (E) - Manages security groups on Apache CloudStack based clouds.
- cs_securitygroup_rule (E) - Manages security group rules on Apache CloudStack based clouds.
- cs_sshkeypair (E) - Manages SSH keys on Apache CloudStack based clouds.
- cs_staticnat (E) - Manages static NATs on Apache CloudStack based clouds.
- cs_template (E) - Manages templates on Apache CloudStack based clouds.
- cs_user (E) - Manages users on Apache CloudStack based clouds.
- cs_vmsnapshot (E) - Manages VM snapshots on Apache CloudStack based clouds.
- docker_login (E) - Manage Docker registry logins
- dynamodb_table (E) - Create, update or delete AWS Dynamo DB tables.
- ec2_ami_copy (E) - copies AMI between AWS regions, return new image id
- ec2_ami_find - Searches for AMIs to obtain the AMI ID and other information
- ec2_elb_facts (E) - Gather facts about EC2 Elastic Load Balancers in AWS
- ec2_eni (E) - Create and optionally attach an Elastic Network Interface (ENI) to an instance
- ec2_eni_facts (E) - Gather facts about ec2 ENI interfaces in AWS
- ec2_remote_facts (E) - Gather facts about ec2 instances in AWS
- ec2_vpc_igw (E) - Manage an AWS VPC Internet gateway
- ec2_vpc_net - Configure AWS virtual private clouds
- ec2_vpc_route_table (E) - Manage route tables for AWS virtual private clouds
- ec2_vpc_route_table_facts (E) - Gather facts about ec2 VPC route tables in AWS
- ec2_vpc_subnet (E) - Manage subnets in AWS virtual private clouds
- ec2_win_password (E) - gets the default administrator password for ec2 windows instances
- ecs_cluster (E) - create or terminate ecs clusters
- ecs_task (E) - run, start or stop a task in ecs
- ecs_taskdefinition (E) - register a task definition in ecs
- elasticache_subnet_group - manage Elasticache subnet groups
- gce_tag (E) - add or remove tag(s) to/from GCE instance
- iam - Manage IAM users, groups, roles and keys
- iam_cert - Manage server certificates for use on ELBs and CloudFront
- iam_policy - Manage IAM policies for users, groups, and roles
- os_auth - Retrieve an auth token
- os_client_config - Get OpenStack Client config
- os_floating_ip - Add/Remove floating IP from an instance
- os_image - Add/Delete images from OpenStack Cloud
- os_image_facts - Retrieve facts about an image within OpenStack.
- os_ironic - Create/Delete Bare Metal Resources from OpenStack
- os_ironic_node - Activate/Deactivate Bare Metal Resources from OpenStack
- os_keypair - Add/Delete a keypair from OpenStack
- os_network - Creates/removes networks from OpenStack
- os_networks_facts - Retrieve facts about one or more OpenStack networks.
- os_nova_flavor - Manage OpenStack compute flavors
- os_object - Create or Delete objects and containers from OpenStack
- os_port - Add/Update/Delete ports from an OpenStack cloud.
- os_project (E) - Manage OpenStack Projects
- os_router - Create or delete routers from OpenStack
- os_security_group - Add/Delete security groups from an OpenStack cloud.
- os_security_group_rule - Add/Delete rule from an existing security group
- os_server - Create/Delete Compute Instances from OpenStack
- os_server_actions - Perform actions on Compute Instances from OpenStack
- os_server_facts - Retrieve facts about one or more compute instances
- os_server_volume - Attach/Detach Volumes from OpenStack VM’s
- os_subnet - Add/Remove subnet to an OpenStack network
- os_subnets_facts - Retrieve facts about one or more OpenStack subnets.
- os_user - Manage OpenStack Identity Users
- os_user_group - Associate OpenStack Identity users and groups
- os_volume - Create/Delete Cinder Volumes
- profitbricks (E) - Create, destroy, start, stop, and reboot a ProfitBricks virtual machine.
- profitbricks_datacenter (E) - Create or destroy a ProfitBricks Virtual Datacenter.
- profitbricks_nic (E) - Create or Remove a NIC.
- profitbricks_volume (E) - Create or destroy a volume.
- profitbricks_volume_attachments (E) - Attach or detach a volume.
- proxmox (E) - management of instances in Proxmox VE cluster
- proxmox_template (E) - management of OS templates in Proxmox VE cluster
- rax_clb_ssl (E) - Manage SSL termination for a Rackspace Cloud Load Balancer.
- rax_mon_alarm (E) - Create or delete a Rackspace Cloud Monitoring alarm.
- rax_mon_check (E) - Create or delete a Rackspace Cloud Monitoring check for an existing entity.
- rax_mon_entity (E) - Create or delete a Rackspace Cloud Monitoring entity
- rax_mon_notification (E) - Create or delete a Rackspace Cloud Monitoring notification.
- rax_mon_notification_plan (E) - Create or delete a Rackspace Cloud Monitoring notification plan.
- route53_facts (E) - Retrieves route53 details using AWS methods
- route53_health_check (E) - add or delete health-checks in Amazons Route53 DNS service
- route53_zone (E) - add or delete Route53 zones
- s3_bucket (E) - Manage s3 buckets in AWS
- s3_lifecycle (E) - Manage s3 bucket lifecycle rules in AWS
- s3_logging (E) - Manage logging facility of an s3 bucket in AWS
- sns_topic (E) - Manages AWS SNS topics and subscriptions
- sqs_queue (E) - Creates or deletes AWS SQS queues.
- sts_assume_role (E) - Assume a role using AWS Security Token Service and obtain temporary credentials
- vca_fw (E) - add remove firewall rules in a gateway in a vca
- vca_nat (E) - add remove nat rules in a gateway in a vca
- vca_vapp (E) - Manages vCloud Air vApp instances.
- virt_net (E) - Manage libvirt network configuration
- virt_pool (E) - Manage libvirt storage pools
- vmware_cluster (E) - Create VMware vSphere Cluster
- vmware_datacenter (E) - Manage VMware vSphere Datacenters
- vmware_dns_config (E) - Manage VMware ESXi DNS Configuration
- vmware_dvs_host (E) - Add or remove a host from distributed virtual switch
- vmware_dvs_portgroup (E) - Create or remove a Distributed vSwitch portgroup
- vmware_dvswitch (E) - Create or remove a distributed vSwitch
- vmware_host (E) - Add/remove ESXi host to/from vCenter
- vmware_migrate_vmk (E) - Migrate a VMK interface from VSS to VDS
- vmware_portgroup (E) - Create a VMware portgroup
- vmware_target_canonical_facts (E) - Return canonical (NAA) from an ESXi host
- vmware_vm_facts (E) - Return basic facts pertaining to a vSphere virtual machine guest
- vmware_vm_vss_dvs_migrate (E) - Migrates a virtual machine from a standard vswitch to distributed
- vmware_vmkernel (E) - Create a VMware VMkernel Interface
- vmware_vmkernel_ip_config (E) - Configure the VMkernel IP Address
- vmware_vsan_cluster (E) - Configure VSAN clustering on an ESXi host
- vmware_vswitch (E) - Add a VMware Standard Switch to an ESXi host
- vsphere_copy (E) - Copy a file to a vCenter datastore
- webfaction_app (E) - Add or remove applications on a Webfaction host
- webfaction_db (E) - Add or remove a database on Webfaction
- webfaction_domain (E) - Add or remove domains and subdomains on Webfaction
- webfaction_mailbox (E) - Add or remove mailboxes on Webfaction
- webfaction_site (E) - Add or remove a website on a Webfaction host
- xenserver_facts (E) - get facts reported on xenserver
Clustering Modules
- consul (E) - Add, modify & delete services within a consul cluster.
- consul_acl (E) - manipulate consul acl keys and rules
- consul_kv (E) - Manipulate entries in the key/value store of a consul cluster.
- consul_session (E) - manipulate consul sessions
- znode (E) - Create, delete, retrieve, and update znodes using ZooKeeper.
Commands Modules
Database Modules
- vertica_configuration (E) - Updates Vertica configuration parameters.
- vertica_facts (E) - Gathers Vertica database facts.
- vertica_role (E) - Adds or removes Vertica database roles and assigns roles to them.
- vertica_schema (E) - Adds or removes Vertica database schema and roles.
- vertica_user (E) - Adds or removes Vertica database users and assigns roles.
Files Modules
- blockinfile (E) - Insert/update/remove a text block surrounded by marker lines.
- find - return a list of files based on specific criteria
Messaging Modules
- rabbitmq_binding (E) - This module manages rabbitMQ bindings
- rabbitmq_exchange (E) - This module manages rabbitMQ exchanges
- rabbitmq_queue (E) - This module manages rabbitMQ queues
Monitoring Modules
- circonus_annotation (E) - create an annotation in circonus
- datadog_monitor (E) - Manages Datadog monitors
- sensu_check (E) - Manage Sensu checks
- zabbix_host (E) - Zabbix host creates/updates/deletes
- zabbix_hostmacro (E) - Zabbix host macro creates/updates/deletes
- zabbix_screen (E) - Zabbix screen creates/updates/deletes
Network Modules
- bigip_gtm_wide_ip (E) - Manages F5 BIG-IP GTM wide ip
- ipify_facts (E) - Retrieve the public IP of your internet gateway.
- nmcli (E) - Manage Networking
- openvswitch_db (E) - Configure open vswitch database.
Notification Modules
- hall (E) - Send notification to Hall
- pushbullet (E) - Sends notifications to Pushbullet
- pushover (E) - Send notifications via https://pushover.net
- sendgrid (E) - Sends an email with the SendGrid API
Packaging Modules
- apk (E) - Manages apk packages
- bundler (E) - Manage Ruby Gem dependencies with Bundler
- dpkg_selections (E) - Dpkg package selection selections
- elasticsearch_plugin (E) - Manage Elasticsearch plugins
- maven_artifact (E) - Downloads an Artifact from a Maven Repository
- package - Generic OS package manager
- pear (E) - Manage pear/pecl packages
- slackpkg (E) - Package manager for Slackware >= 12.2
System Modules
- cronvar (E) - Manage variables in crontabs
- iptables (E) - Modify the systems iptables
- osx_defaults (E) - osx_defaults allows users to read, write, and delete Mac OS X user defaults from Ansible
- pam_limits (E) - Modify Linux PAM limits
- puppet (E) - Runs puppet
- selinux_permissive (E) - Change permissive domain in SELinux policy
- seport (E) - Manages SELinux network port type definitions
- solaris_zone (E) - Manage Solaris zones
Web Infrastructure Modules
- deploy_helper (E) - Manages some of the steps common in deploying projects.
- taiga_issue (E) - Creates/deletes an issue in a Taiga Project Management Platform
Windows Modules
- win_acl (E) - Set file/directory permissions for a system user or group.
- win_dotnet_ngen (E) - Runs ngen to recompile DLLs after .NET updates
- win_environment (E) - Modifies environment variables on windows hosts.
- win_firewall_rule (E) - Windows firewall automation
- win_iis_virtualdirectory (E) - Configures a virtual directory in IIS.
- win_iis_webapplication (E) - Configures a IIS Web application.
- win_iis_webapppool (E) - Configures a IIS Web Application Pool.
- win_iis_webbinding (E) - Configures a IIS Web site.
- win_iis_website (E) - Configures a IIS Web site.
- win_lineinfile - Ensure a particular line is in a file, or replace an existing line using a back-referenced regular expression.
- win_nssm (E) - NSSM - the Non-Sucking Service Manager
- win_regedit (E) - Add, Edit, or Remove Registry Keys and Values
- win_scheduled_task (E) - Manage scheduled tasks
- win_unzip (E) - Unzips compressed files and archives on the Windows node
- win_updates (E) - Download and install Windows updates
- win_webpicmd (E) - Installs packages using Web Platform Installer command-line
Options added in version 2.0
Cloud Modules
-
azure - create or terminate a virtual machine in azure
- auto_updates: Enable Auto Updates on Windows Machines
- enable_winrm: Enable winrm on Windows Machines
- os_type: The type of the os that is gettings provisioned
-
cloudformation - Create or delete an AWS CloudFormation stack
- notification_arns: The Simple Notification Service (SNS) topic ARNs to publish stack related events.
- template_format: For local templates, allows specification of json or yaml format
- template_url: Location of file containing the template body. The URL must point to a template (max size 307,200 bytes) located in an S3 bucket in the same region as the stack. This parameter is mutually exclusive with 'template'. Either one of them is required if "state" parameter is "present"
-
digital_ocean - Create/delete a droplet/SSH_key in DigitalOcean
- user_data: opaque blob of data which is made available to the droplet
-
docker_image - manage docker images
- docker_api_version: Remote API version to use. This defaults to the current default as specified by docker-py.
- dockerfile: Dockerfile to use
- tls_ca_cert: Path to a PEM-encoded certificate authority to secure the Docker connection. This has no effect if use_tls is encrypt.
- tls_client_cert: Path to the PEM-encoded certificate used to authenticate docker client. If specified tls_client_key must be valid
- tls_client_key: Path to the PEM-encoded key used to authenticate docker client. If specified tls_client_cert must be valid
- tls_hostname: A hostname to check matches what's supplied in the docker server's certificate. If unspecified, the hostname is taken from the docker_url.
- use_tls: Whether to use tls to connect to the docker server. "no" means not to use tls (and ignore any other tls related parameters). "encrypt" means to use tls to encrypt the connection to the server. "verify" means to also verify that the server's certificate is valid for the server (this both verifies the certificate against the CA and that the certificate was issued for that host. If this is unspecified, tls will only be used if one of the other tls options require it.
-
docker - manage docker containers
- cap_add: Add capabilities for the container. Requires docker-py >= 0.5.0.
- cap_drop: Drop capabilities for the container. Requires docker-py >= 0.5.0.
- cpu_set: CPUs in which to allow execution. Requires docker-py >= 0.6.0.
- docker_user: Username or UID to use within the container
- extra_hosts: Dict of custom host-to-IP mappings to be defined in the container
- log_driver: You can specify a different logging driver for the container than for the daemon. "json-file" Default logging driver for Docker. Writes JSON messages to file. docker logs command is available only for this logging driver. "none" disables any logging for the container. "syslog" Syslog logging driver for Docker. Writes log messages to syslog. docker logs command is not available for this logging driver. "journald" Journald logging driver for Docker. Writes log messages to "journald". "gelf" Graylog Extended Log Format (GELF) logging driver for Docker. Writes log messages to a GELF endpoint likeGraylog or Logstash. "fluentd" Fluentd logging driver for Docker. Writes log messages to "fluentd" (forward input). "awslogs" (added in 2.1) Awslogs logging driver for Docker. Writes log messages to AWS Cloudwatch Logs. If not defined explicitly, the Docker daemon's default ("json-file") will apply. Requires docker >= 1.6.0.
- log_opt: Additional options to pass to the logging driver selected above. See Docker
log-driver <https://docs.docker.com/reference/logging/overview/>
documentation for more information. Requires docker >=1.7.0. - read_only: Mount the container's root filesystem as read only
- signal: With the state "killed", you can alter the signal sent to the container.
- stop_timeout: How many seconds to wait for the container to stop before killing it.
-
ec2 - create, terminate, start or stop an instance in ec2
- network_interfaces: A list of existing network interfaces to attach to the instance at launch. When specifying existing network interfaces, none of the assign_public_ip, private_ip, vpc_subnet_id, group, or group_id parameters may be used. (Those parameters are for creating a new network interface at launch.)
aliases: network_interface - spot_type: Type of spot request; one of "one-time" or "persistent". Defaults to "one-time" if not supplied.
- termination_protection: Enable or Disable the Termination Protection
- network_interfaces: A list of existing network interfaces to attach to the instance at launch. When specifying existing network interfaces, none of the assign_public_ip, private_ip, vpc_subnet_id, group, or group_id parameters may be used. (Those parameters are for creating a new network interface at launch.)
-
ec2_ami - create or destroy an image in ec2
- device_mapping: An optional list of device hashes/dictionaries with custom configurations (same block-device-mapping parameters)Valid properties include: device_name, volume_type, size (in GB), delete_on_termination (boolean), no_device (boolean), snapshot_id, iops (for io1 volume_type)
- launch_permissions: Users and groups that should be able to launch the ami. Expects dictionary with a key of user_ids and/or group_names. user_ids should be a list of account ids. group_name should be a list of groups, "all" is the only acceptable value currently.
- tags: a hash/dictionary of tags to add to the new image; '{"key":"value"}' and '{"key":"value","key":"value"}'
-
ec2_asg - Create or delete AWS Autoscaling Groups
- default_cooldown: The number of seconds after a scaling activity completes before another can begin.
- termination_policies: An ordered list of criteria used for selecting instances to be removed from the Auto Scaling group when reducing capacity.For 'Default', when used to create a new autoscaling group, the "Default" value is used. When used to change an existent autoscaling group, the current termination policies are mantained
-
ec2_eip - associate an EC2 elastic IP with an instance.
- device_id: The id of the device for the EIP. Can be an EC2 Instance id or Elastic Network Interface (ENI) id.
aliases: instance_id - release_on_disassociation: whether or not to automatically release the EIP when it is disassociated
- device_id: The id of the device for the EIP. Can be an EC2 Instance id or Elastic Network Interface (ENI) id.
-
ec2_elb_lb - Creates or destroys Amazon ELB.
- access_logs: An associative array of access logs configuration settings (see example)
- idle_timeout: ELB connections from clients and to servers are timed out after this amount of time
- security_group_names: A list of security group names to apply to the elb
- stickiness: An associative array of stickness policy settings. Policy will be applied to all listeners ( see example )
-
ec2_lc - Create or delete AWS Autoscaling Launch Configurations
- classic_link_vpc_id: Id of ClassicLink enabled VPC
- classic_link_vpc_security_groups: A list of security group id's with which to associate the ClassicLink VPC instances.
-
ec2_snapshot - creates a snapshot from an existing volume
- last_snapshot_min_age: If the volume's most recent snapshot has started less than `last_snapshot_min_age' minutes ago, a new snapshot will not be created.
-
elasticache - Manage cache clusters in Amazon Elasticache.
- cache_parameter_group: The name of the cache parameter group to associate with this cache cluster. If this argument is omitted, the default cache parameter group for the specified engine will be used.
aliases: parameter_group - cache_subnet_group: The subnet group name to associate with. Only use if inside a vpc. Required if inside a vpc
- cache_parameter_group: The name of the cache parameter group to associate with this cache cluster. If this argument is omitted, the default cache parameter group for the specified engine will be used.
-
gce_img (E) - utilize GCE image resources
- timeout: timeout for the operation
-
gc_storage - This module manages objects/buckets in Google Cloud Storage.
- headers: Headers to attach to object.
-
gce - create or terminate GCE instances
- service_account_permissions: service account permissions (see https://cloud.google.com/sdk/gcloud/reference/compute/instances/create, --scopes section for detailed information)
-
lxc_container (E) - Manage LXC Containers
- clone_name: Name of the new cloned server. This is only used when state is clone.
- clone_snapshot: Create a snapshot a container when cloning. This is not supported by all container storage backends. Enabling this may fail if the backing store does not support snapshots.
-
rax_cdb - create/delete or resize a Rackspace Cloud Databases instance
- cdb_type: type of instance (i.e. MySQL, MariaDB, Percona)
aliases: type - cdb_version: version of database (MySQL supports 5.1 and 5.6, MariaDB supports 10, Percona supports 5.6)
aliases: version
- cdb_type: type of instance (i.e. MySQL, MariaDB, Percona)
-
rds - create, delete, or modify an Amazon rds instance
- force_failover: Used only when command=reboot. If enabled, the reboot is done using a MultiAZ failover.
-
route53 - add or delete entries in Amazons Route53 DNS service
- failover: Failover resource record sets only. Whether this is the primary or secondary resource record set.
- health_check: Health check to associate with this record
- hosted_zone_id: The Hosted Zone ID of the DNS zone to modify
- identifier: Weighted and latency-based resource record sets only. An identifier that differentiates among multiple resource record sets that have the same combination of DNS name and type.
- region: Latency-based resource record sets only Among resource record sets that have the same combination of DNS name and type, a value that determines which region this should be associated with for the latency-based routing
- vpc_id: When used in conjunction with private_zone: true, this will only modify records in the private hosted zone attached to this VPC.This allows you to have multiple private hosted zones, all with the same name, attached to different VPCs.
- weight: Weighted resource record sets only. Among resource record sets that have the same combination of DNS name and type, a value that determines what portion of traffic for the current resource record set is routed to the associated location.
-
s3 - manage objects in S3.
- encrypt: When set for PUT mode, asks for server-side encryption
- headers: Custom headers for PUT operation, as a dictionary of 'key=value' and 'key=value,key=value'.
- marker: Specifies the key to start with when using list mode. Object keys are returned in alphabetical order, starting with key after the marker in order.
- max_keys: Max number of results to return in list mode, set this if you want to retrieve fewer than the default 1000 keys.
- permission: This option let's the user set the canned permissions on the object/bucket that are created. The permissions that can be set are 'private', 'public-read', 'public-read-write', 'authenticated-read'. Multiple permissions can be specified as a list.
- prefix: Limits the response to keys that begin with the specified prefix for list mode
- retries: On recoverable failure, how many times to retry before actually failing.
- version: Version ID of the object inside the bucket. Can be used to get a specific version of a file if versioning is enabled in the target bucket.
-
vsphere_guest - Create/delete/manage a guest VM through VMware vSphere.
- snapshot_to_clone: A string that when specified, will create a linked clone copy of the VM. Snapshot must already be taken in vCenter.
Database Modules
-
mongodb_user (E) - Adds or removes a user from a MongoDB database.
- login_database: The database where login credentials are stored
-
mysql_db - Add or remove MySQL databases from a remote host.
- config_file: Specify a config file from which user and password are to be read
- ssl_ca: The path to a Certificate Authority (CA) certificate. This option, if used, must specify the same certificate as used by the server.
- ssl_cert: The path to a client public key certificate.
- ssl_key: The path to the client private key.
-
mysql_replication (E) - Manage MySQL replication
- config_file: Specify a config file from which user and password are to be read
- master_auto_position: does the host uses GTID based replication or not
- ssl_ca: The path to a Certificate Authority (CA) certificate. This option, if used, must specify the same certificate as used by the server.
- ssl_cert: The path to a client public key certificate.
- ssl_key: The path to the client private key.
-
mysql_user - Adds or removes a user from a MySQL database.
- config_file: Specify a config file from which user and password are to be read
- encrypted: Indicate that the 'password' field is a
mysql_native_password
hash - ssl_ca: The path to a Certificate Authority (CA) certificate. This option, if used, must specify the same certificate as used by the server.
- ssl_cert: The path to a client public key certificate.
- ssl_key: The path to the client private key.
- update_password: always will update passwords if they differ. on_create will only set the password for newly created users.
-
mysql_variables - Manage MySQL global variables
- config_file: Specify a config file from which user and password are to be read
- ssl_ca: The path to a Certificate Authority (CA) certificate. This option, if used, must specify the same certificate as used by the server.
- ssl_cert: The path to a client public key certificate.
- ssl_key: The path to the client private key.
-
postgresql_user - Adds or removes a users (roles) from a PostgreSQL database.
- no_password_changes: if yes, don't inspect database for password changes. Effective when pg_authid is not accessible (such as AWS RDS). Otherwise, make password changes as necessary.
Files Modules
-
acl - Sets and retrieves file ACL information.
- recursive: Recursively sets the specified ACL (added in Ansible 2.0). Incompatible with state=query.
-
assemble - Assembles a configuration file from fragments
- ignore_hidden: A boolean that controls if files that start with a '.' will be included or not.
- validate: The validation command to run before copying into place. The path to the file to validate is passed in via '%s' which must be present as in the sshd example below. The command is passed securely so shell features like expansion and pipes won't work.
-
copy - Copies files to remote locations.
- remote_src: If False, it will search for src at originating/master machine, if True it will go to the remote/target machine for the src. Default is False.Currently remote_src does not support recursive copying.
-
patch (E) - Apply patch files using the GNU patch tool.
- backup: passes --backup --version-control=numbered to patch, producing numbered backup copies
- binary: Setting to yes will disable patch's heuristic for transforming CRLF line endings into LF. Line endings of src and dest must match. If set to no, patch will replace CRLF in src files on POSIX.
-
stat - retrieve file or file system status
- checksum_algorithm: Algorithm to determine checksum of file. Will throw an error if the host is unable to use specified algorithm.
aliases: checksum_algo, checksum
- checksum_algorithm: Algorithm to determine checksum of file. Will throw an error if the host is unable to use specified algorithm.
-
synchronize - Uses rsync to make synchronizing file paths in your playbooks quick and easy.
- partial: Tells rsync to keep the partial file which should make a subsequent transfer of the rest of the file much faster.
- use_ssh_args: Use the ssh_args specified in ansible.cfg
- verify_host: Verify destination host key.
-
unarchive - Unpacks an archive after (optionally) copying it from the local machine.
- list_files: If set to True, return the list of files that are contained in the tarball.
Monitoring Modules
-
nagios (E) - Perform common tasks in Nagios related to downtime and notifications.
- comment: Comment for downtime action.
- servicegroup: The Servicegroup we want to set downtimes/alerts for. Required option when using the servicegroup_service_downtime amd servicegroup_host_downtime.
Network Modules
-
bigip_facts (E) - Collect facts from F5 BIG-IP devices
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
bigip_monitor_http (E) - Manages F5 BIG-IP LTM http monitors
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
bigip_node (E) - Manages F5 BIG-IP LTM nodes
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
bigip_pool (E) - Manages F5 BIG-IP LTM pools
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
bigip_monitor_tcp (E) - Manages F5 BIG-IP LTM tcp monitors
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
bigip_pool_member (E) - Manages F5 BIG-IP LTM pool members
- monitor_state: Set monitor availability status for pool member
- session_state: Set new session availability status for pool member
- validate_certs: If no, SSL certificates will not be validated. This should only be used on personally controlled sites. Prior to 2.0, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8
-
get_url - Downloads files from HTTP, HTTPS, or FTP to node
- checksum: If a checksum is passed to this parameter, the digest of the destination file will be calculated after it is downloaded to ensure its integrity and verify that the transfer completed successfully. Format: :, e.g.: checksum="sha256:D98291AC[...]B6DC7B97" If you worry about portability, only the sha1 algorithm is available on all platforms and python versions. The third party hashlib library can be installed for access to additional algorithms. Additionaly, if a checksum is passed to this parameter, and the file exist under the dest location, the destination_checksum would be calculated, and if checksum equals destination_checksum, the file download would be skipped (unless force is true).
- force_basic_auth: httplib2, the library used by the uri module only sends authentication information when a webservice responds to an initial request with a 401 status. Since some basic auth services do not properly send a 401, logins will fail. This option forces the sending of the Basic authentication header upon initial request.
- headers: Add custom HTTP headers to a request in the format "key:value,key:value"
-
haproxy (E) - Enable, disable, and set weights for HAProxy backend servers using socket commands.
- wait: Wait until the server reports a status of 'UP' when
state=enabled
, or status of 'MAINT' whenstate=disabled
. - wait_interval: Number of seconds to wait between retries.
- wait_retries: Number of times to check for status after changing the state.
- wait: Wait until the server reports a status of 'UP' when
-
openvswitch_bridge (E) - Manage Open vSwitch bridges
- external_ids: A dictionary of external-ids. Omitting this parameter is a No-op. To clear all external-ids pass an empty value.
- fail_mode: Set bridge fail-mode. The default value (None) is a No-op.
-
openvswitch_port (E) - Manage Open vSwitch ports
- external_ids: Dictionary of external_ids applied to a port.
- set: Set a single property on a port.
-
uri - Interacts with webservices
- body_format: The serialization format of the body. When set to json, encodes the body argument, if needed, and automatically sets the Content-Type header accordingly.
Notification Modules
-
irc (E) - Send a message to an IRC channel
- nick_to: A list of nicknames to send the message to. One of nick_to or channel needs to be set. When both are defined, the message will be sent to both of them.
- part: Designates whether user should part from channel after sending message or not. Useful for when using a faux bot and not wanting join/parts between messages.
- style: Text style for the message. Note italic does not work on some clients
- topic: Set the channel topic
-
mail (E) - Send an email
- subtype: The minor mime type, can be either text or html. The major type is always text.
-
slack (E) - Send Slack notifications
- color: Allow text to use default colors - use the default of 'normal' to not send a custom color bar at the start of the message
Packaging Modules
-
bower (E) - Manage bower packages with bower
- production: Install with --production flag
-
composer (E) - Dependency Manager for PHP
- arguments: Composer arguments like required package, version and so on
- ignore_platform_reqs: Ignore php, hhvm, lib-* and ext-* requirements and force the installation even if the local machine does not fulfill these.
aliases: ignore-platform-reqs
-
cpanm (E) - Manages Perl library dependencies.
- installdeps: Only install dependencies
- system_lib: Use this if you want to install modules to the system perl include path. You must be root or have "passwordless" sudo for this to work.This uses the cpanm commandline option '--sudo', which has nothing to do with ansible privilege escalation.
aliases: use_sudo
-
easy_install - Installs Python libraries
- state: The desired state of the library. latest ensures that the latest version is installed.
-
gem - Manage Ruby gems
- build_flags: Allow adding build flags for gem compilation
- include_doc: Install with or without docs.
-
opkg (E) - Package manager for OpenWrt
- force: opkg --force parameter used
-
pacman (E) - Manage packages with pacman
- force: Force remove package, without any checks.
- upgrade: Whether or not to upgrade whole system
-
pip - Manages Python library dependencies.
- editable: Pass the editable flag for versioning URLs.
- virtualenv_python: The Python executable used for creating the virtual environment. For example python3.4, python2.7. When not specified, the system Python version is used.
-
redhat_subscription - Manage Red Hat Network registration and subscriptions using the subscription-manager command
- org_id: Organisation ID to use in conjunction with activationkey
-
rhn_register - Manage Red Hat Network registration using the rhnreg_ks command
- profilename: supply an profilename for use with registration
-
yum - Manages packages with the yum package manager
- exclude: Package name(s) to exclude when state=present, or latest
-
zypper (E) - Manage packages on SUSE and openSUSE
- type: The type of package to be operated on.
Source Control Modules
-
git - Deploy software (or files) from git checkouts
- verify_commit: if yes, when cloning or checking out a version verify the signature of a GPG signed commit. This requires git version>=2.1.0 to be installed. The commit MUST be signed and the public key MUST be trusted in the GPG trustdb.
-
hg - Manages Mercurial (hg) repositories.
- update: If no, do not retrieve new revisions from the origin repository
-
subversion - Deploys a subversion repository.
- switch: If no, do not call svn switch before update.
System Modules
-
cron - Manage cron.d and crontab entries.
- disabled: If the job should be disabled (commented out) in the crontab. Only has effect if state=present
-
filesystem (E) - Makes file system on block device
- resizefs: If yes, if the block device and filessytem size differ, grow the filesystem into the space. Note, XFS Will only grow if mounted.
-
firewalld (E) - Manage arbitrary ports/services with firewalld
- source: The source/network you would like to add/remove to/from firewalld
-
lvol (E) - Configure LVM logical volumes
- opts: Free-form options to be passed to the lvcreate command
-
user - Manage user accounts
- skeleton: Optionally set a home skeleton directory. Requires createhome option!
Windows Modules
-
win_get_url - Fetches a file from a given URL
- force: If yes, will always download the file. If no, will only download the file if it does not exist or the remote file has been modified more recently than the local file.
- proxy_password: Proxy authentication password
- proxy_url: The full URL of the proxy server to download through.
- proxy_username: Proxy authentication username