LoginSignup
4
3

More than 5 years have passed since last update.

@muziyoshiz(Masahiro Yoshizawa)

Ansible 2.1 の新モジュール、新オプション一覧

Last updated at Posted at 2016-06-05

自作のクローラで自動生成した、Ansible 2.1 の新モジュール、新オプション一覧です。以前投稿した Ansible 2.0 の新モジュール、新オプション一覧 の Ansible 2.1 版です。2.1 から RC がいつの間にか取れていたので、改めて作成しました。

ざっと見た限りでは、Azure のようなクラウドサービスや、Docker 関係のモジュールがかなり増えていますね。あと、意外なところでは make なんてモジュールが増えてました。

この一覧を作るのに使ったクローラの詳細については、はてなブログの Ansible 2.0 で追加されたモジュールおよびオプション一覧を無理矢理作る - 無印吉澤 をご参照ください。

Modules added in version 2.1

Cloud Modules

Clustering Modules

Database Modules

Network Modules

Packaging Modules

Source Control Modules

System Modules

Windows Modules

Options added in version 2.1

Cloud Modules

  • cs_instance (E) - Manages instances and virtual machines on Apache CloudStack based clouds.
    • template_filter: Name of the filter used to search for the template or iso.Used for params iso or template on state=present. aliases: iso_filter
  • docker_image - Manage docker images.
    • archive_path: Use with state 'present' to archive an image to a .tar file.
    • container_limits: A dictionary of limits applied to each container created by the build process.
    • force: Use with absent state to un-tag and remove all images matching the specified name. Use with states 'present' and 'tagged' to take action even when an image already exists.
    • http_timeout: Timeout for HTTP requests during the image build operation. Provide a positive integer value for the number of seconds.
    • pull: When building an image downloads any updates to the FROM image in Dockerfile.
    • repository: Full path to a repository. Use with state 'present' to tag the image into the repository.
    • rm: Remove intermediate containers after build.
  • docker - manage docker containers
    • cpu_shares: CPU shares (relative weight). Requires docker-py >= 0.6.0.
    • devices: List of host devices to expose to container
    • entrypoint: Corresponds to --entrypoint option of docker run command and ENTRYPOINT directive of Dockerfile. Used to match and launch containers.
    • env_file: Pass in a path to a file with environment variable (FOO=BAR). If a key value is present in both explicitly presented (i.e. as 'env') and in the environment file, the explicit value will override. Requires docker-py >= 1.4.0.
    • labels: Set container labels. Requires docker >= 1.6 and docker-py >= 1.2.0.
    • timeout: Docker daemon response timeout in seconds.
    • ulimits: ulimits, list ulimits with name, soft and optionally hard limit separated by colons. e.g. nofile:1024:2048 Requires docker-py >= 1.2.0 and docker >= 1.6.0
  • dynamodb_table (E) - Create, update or delete AWS Dynamo DB tables.
    • indexes: list of dictionaries describing indexes to add to the table. global indexes can be updated. local indexes don't support updates or have throughput.required options: ['name', 'type', 'hash_key_name']valid types: ['all', 'global_all', 'global_include', 'global_keys_only', 'include', 'keys_only']other options: ['hash_key_type', 'range_key_name', 'range_key_type', 'includes', 'read_capacity', 'write_capacity']
  • ec2 - create, terminate, start or stop an instance in ec2
  • ec2_elb_lb - Creates or destroys Amazon ELB.
    • instance_ids: List of instance ids to attach to this ELB
    • purge_instance_ids: Purge existing instance ids on ELB that are not found in instance_ids
    • tags: An associative array of tags. To delete all tags, supply an empty dict.
    • wait: When specified, Ansible will check the status of the load balancer to ensure it has been successfully removed from AWS.
    • wait_timeout: Used in conjunction with wait. Number of seconds to wait for the elb to be terminated. A maximum of 600 seconds (10 minutes) is allowed.
  • ec2_vol - create and attach a volume, return volume id and device map
    • delete_on_termination: When set to "yes", the volume will be deleted upon instance termination.
  • gce - create or terminate GCE instances
    • credentials_file: path to the JSON file associated with the service account email
    • preemptible: if set to true, instances will be preemptible and time-limited. (requires libcloud >= 0.20.0)
  • gce_net - create/destroy GCE networks and firewall rules
    • credentials_file: path to the JSON file associated with the service account email
  • gce_pd - utilize GCE persistent disk resources
    • credentials_file: path to the JSON file associated with the service account email
  • gce_lb - create/destroy GCE load-balancer resources
    • credentials_file: path to the JSON file associated with the service account email
  • os_floating_ip - Add/Remove floating IP from an instance
    • purge: When state is absent, indicates whether or not to delete the floating IP completely, or only detach it from the server. Default is to detach only.
  • os_network - Creates/removes networks from OpenStack
    • project: Project name or ID containing the network (name admin-only)
    • provider_network_type: The type of physical network that maps to this network resource.
    • provider_physical_network: The physical network where this network object is implemented.
    • provider_segmentation_id: An isolated segment on the physical network. The network_type attribute defines the segmentation model. For example, if the network_type value is vlan, this ID is a vlan identifier. If the network_type value is gre, this ID is a gre key.
  • os_server - Create/Delete Compute Instances from OpenStack
    • scheduler_hints: Arbitrary key/value pairs to the scheduler for custom use
  • os_subnet - Add/Remove subnet to an OpenStack network
    • project: Project name or ID containing the subnet (name admin-only)
  • ovirt (E) - oVirt/RHEV platform management
    • instance_dns: define the instance's Primary DNS server aliases: dns
    • instance_domain: define the instance's Domain aliases: domain
    • instance_hostname: define the instance's Hostname aliases: hostname
    • instance_ip: define the instance's IP aliases: ip
    • instance_key: define the instance's Authorized key aliases: key
    • instance_netmask: define the instance's Netmask aliases: netmask
    • instance_rootpw: define the instance's Root password aliases: rootpw
  • rax_dns_record - Manage DNS records on Rackspace Cloud DNS
    • overwrite: Add new records if data doesn't match, instead of updating existing record with matching name. If there are already multiple records with matching name and overwrite=true, this module will fail.
  • route53 - add or delete entries in Amazons Route53 DNS service
    • alias_evaluate_target_health: Whether or not to evaluate an alias target health. Useful for aliases to Elastic Load Balancers.
    • wait: Wait until the changes have been replicated to all Amazon Route 53 DNS servers.
    • wait_timeout: How long to wait for the changes to be replicated, in seconds.
  • sqs_queue (E) - Creates or deletes AWS SQS queues.
    • policy: The json dict policy to attach to queue
  • vsphere_guest - Create/delete/manage a guest VM through VMware vSphere.
    • validate_certs: Validate SSL certs. Note, if running on python without SSLContext support (typically, python < 2.7.9) you will have to set this to no as pysphere does not support validating certificates on older python. Prior to 2.1, this module would always validate on python >= 2.7.9 and never validate on python <= 2.7.8.

Clustering Modules

Database Modules

Files Modules

Messaging Modules

Monitoring Modules

Network Modules

  • bigip_pool_member (E) - Manages F5 BIG-IP LTM pool members
    • preserve_node: When state is absent and the pool member is no longer referenced in other pools, the default behavior removes the unused node object. Setting this to 'yes' disables this behavior.
  • get_url - Downloads files from HTTP, HTTPS, or FTP to node
    • backup: Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
    • tmp_dest: absolute path of where temporary file is downloaded to.Defaults to TMPDIR, TEMP or TMP env variables or a platform specific valuehttps://docs.python.org/2/library/tempfile.html#tempfile.tempdir
  • uri - Interacts with webservices
    • headers: Add custom HTTP headers to a request in the format of a YAML hash

Packaging Modules

  • apt - Manages apt-packages
    • allow_unauthenticated: Ignore if packages cannot be authenticated. This is useful for bootstrapping environments that manage their own apt-key setup.
    • autoremove: If yes, remove unused dependency packages for all module states except build-dep. aliases: autoclean
    • only_upgrade: Only install/upgrade a package if it is already installed.
  • apt_repository - Add and remove APT repositories
    • filename: Sets the name of the source list file in sources.list.d. Defaults to a file name based on the repository source url. The .list extension will be automatically added.
  • bower (E) - Manage bower packages with bower
    • relative_execpath: Relative path to bower executable from install path
  • cpanm (E) - Manages Perl library dependencies.
    • executable: Override the path to the cpanm executable
    • version: minimum version of perl module to consider acceptable
  • elasticsearch_plugin (E) - Manage Elasticsearch plugins
    • proxy_host: Proxy host to use during plugin installation
    • proxy_port: Proxy port to use during plugin installation
  • openbsd_pkg (E) - Manage packages on OpenBSD.
    • build: Build the package from source instead of downloading and installing a binary. Requires that the port source tree is already installed. Automatically builds and installs the 'sqlports' package, if it is not already installed.
    • ports_dir: When used in combination with the 'build' option, allows overriding the default ports source directory.
  • pip - Manages Python library dependencies.
    • umask: The system umask to apply before installing the pip package. This is useful, for example, when installing on systems that have a very restrictive umask by default (e.g., 0077) and you want to pip install packages which are to be used by all users. Note that this requires you to specify desired umask mode in octal, with a leading 0 (e.g., 0077).
  • pkgin (E) - Package manager for SmartOS, NetBSD, et al.
    • clean: Clean packages cache
    • force: Force package reinstall
    • full_upgrade: Upgrade all packages to their newer versions
    • update_cache: Update repository database. Can be run with other steps or on it's own.
    • upgrade: Upgrade main packages to their newer versions
  • pkgng (E) - Package manager for FreeBSD >= 9.0
    • chroot: pkg will chroot in the specified environmentcan not be used together with 'rootdir' option
  • pkgutil (E) - Manage CSW-Packages on Solaris
    • update_catalog: If you want to refresh your catalog from the mirror, set this to (yes).
  • redhat_subscription - Manage Red Hat Network registration and subscriptions using the subscription-manager command
    • consumer_id: References an existing consumer ID to resume using a previous registration for this system. If the system's identity certificate is lost or corrupted, this option allows it to resume using its previous identity and subscriptions. The default is to not specify a consumer ID so a new ID is created.
    • consumer_name: Name of the system to register, defaults to the hostname
    • consumer_type: The type of unit to register, defaults to system
  • rhn_register - Manage Red Hat Network registration using the rhnreg_ks command
    • sslcacert: supply a custom ssl CA certificate file for use with registration
    • systemorgid: supply an organizational id for use with registration
  • yum - Manages packages with the yum package manager
    • validate_certs: This only applies if using a https url as the source of the rpm. e.g. for localinstall. If set to no, the SSL certificates will not be validated.This should only set to no used on personally controlled sites using self-signed certificates as it avoids verifying the source site.Prior to 2.1 the code worked as if this was set to yes.
  • zypper_repository (E) - Add and remove Zypper repositories
    • overwrite_multiple: Overwrite multiple repository entries, if repositories with both name and URL already exist.
    • priority: Set priority of repository. Packages will always be installed from the repository with the smallest priority number.

System Modules

  • authorized_key - Adds or removes an SSH authorized key
    • validate_certs: This only applies if using a https url as the source of the keys. If set to no, the SSL certificates will not be validated.This should only set to no used on personally controlled sites using self-signed certificates as it avoids verifying the source site.Prior to 2.1 the code worked as if this was set to yes.
  • cron - Manage cron.d and crontab entries.
    • env: If set, manages a crontab's environment variable. New variables are added on top of crontab. "name" and "value" paramenters are the name and the value of environment variable.
    • insertafter: Used with state=present and env. If specified, the environment variable will be inserted after the declaration of specified environment variable.
    • insertbefore: Used with state=present and env. If specified, the environment variable will be inserted before the declaration of specified environment variable.
  • firewalld (E) - Manage arbitrary ports/services with firewalld
    • interface: The interface you would like to add/remove to/from a zone in firewalld
    • masquerade: The masquerade setting you would like to enable/disable to/from zones within firewalld
  • iptables (E) - Modify the systems iptables
    • limit_burst: Specifies the maximum burst before the above limit kicks in.
    • reject_with: Specifies the error packet type to return while rejecting.
    • set_dscp_mark: This allows specifying a DSCP mark to be added to packets. It takes either an integer or hex value. Mutually exclusive with set_dscp_mark_class.
    • set_dscp_mark_class: This allows specifying a predefined DiffServ class which will be translated to the corresponding DSCP mark. Mutually exclusive with set_dscp_mark.
    • to_destination: This specifies a destination address to use with DNAT: without this, the destination address is never altered.
    • uid_owner: Specifies the UID or username to use in match by owner rule.
  • lvol (E) - Configure LVM logical volumes
    • snapshot: The name of the snapshot volume
  • osx_defaults (E) - osx_defaults allows users to read, write, and delete Mac OS X user defaults from Ansible
    • host: The host on which the preference should apply. The special value "currentHost" corresponds to the "-currentHost" switch of the defaults commandline tool.
  • puppet (E) - Runs puppet
    • certname: The name to use when handling certificates.
    • execute: Execute a specific piece of Puppet code. It has no effect with a puppetmaster.
    • logdest: Where the puppet logs should go, if puppet apply is being used
    • tags: A comma-separated list of puppet tags to be used.
  • setup - Gathers facts about remote hosts
    • gather_subset: if supplied, restrict the additional facts collected to the given subset. Possible values: all, hardware, network, virtual, ohai, and facter Can specify a list of values to specify a larger subset. Values can also be used with an initial ! to specify that that specific subset should not be collected. For instance: !hardware, !network, !virtual, !ohai, !facter. Note that a few facts are always collected. Use the filter parameter if you do not want to display those.
  • user - Manage user accounts
    • seuser: Optionally sets the seuser type (user_u) on selinux enabled systems.

Utilities Modules

Web Infrastructure Modules

Windows Modules

4
3
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
4
3