rax_meta - Manipulate metadata for Rackspace Cloud Servers

Author:Matt Martz

Synopsis

New in version 1.7.

Manipulate metadata for Rackspace Cloud Servers

Options

parameter required default choices comments
address no
    Server IP address to modify metadata for, will match any IP assigned to the server
    api_key no
      Rackspace API key (overrides credentials)
      auth_endpoint no https://identity.api.rackspacecloud.com/v2.0/
        The URI of the authentication service (added in Ansible 1.5)
        credentials no
          File to find the Rackspace credentials in (ignored if api_key and username are provided)
          env no
            Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration (added in Ansible 1.5)
            id no
              Server ID to modify metadata for
              identity_type no rackspace
                Authentication machanism to use, such as rackspace or keystone (added in Ansible 1.5)
                meta no
                  A hash of metadata to associate with the instance
                  name no
                    Server name to modify metadata for
                    region no DFW
                      Region to create an instance in
                      tenant_id no
                        The tenant ID used for authentication (added in Ansible 1.5)
                        tenant_name no
                          The tenant name used for authentication (added in Ansible 1.5)
                          username no
                            Rackspace username (overrides credentials)
                            verify_ssl no
                              Whether or not to require SSL validation of API endpoints (added in Ansible 1.5)

                              Note

                              Requires pyrax

                              Examples


                              - name: Set metadata for a server
                                hosts: all
                                gather_facts: False
                                tasks:
                                  - name: Set metadata
                                    local_action:
                                      module: rax_meta
                                      credentials: ~/.raxpub
                                      name: "{{ inventory_hostname }}"
                                      region: DFW
                                      meta:
                                        group: primary_group
                                        groups:
                                          - group_two
                                          - group_three
                                        app: my_app
                              
                                  - name: Clear metadata
                                    local_action:
                                      module: rax_meta
                                      credentials: ~/.raxpub
                                      name: "{{ inventory_hostname }}"
                                      region: DFW

                              Note

                              The following environment variables can be used, RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.

                              Note

                              RAX_CREDENTIALS and RAX_CREDS_FILE points to a credentials file appropriate for pyrax. See https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating

                              Note

                              RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

                              Note

                              RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)