update generated modules (#26)

library/k8s_v1_role_binding.py

@@ -0,0 +1,208 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+from ansible.module_utils.k8s_common import KubernetesAnsibleModule, KubernetesAnsibleException
+
+DOCUMENTATION = '''
+module: k8s_v1_role_binding
+short_description: Kubernetes RoleBinding
+description:
+- Manage the lifecycle of a role_binding object. Supports check mode, and attempts
+  to to be idempotent.
+version_added: 2.3.0
+author: OpenShift (@openshift)
+options:
+  annotations:
+    description:
+    - Annotations is an unstructured key value map stored with a resource that may
+      be set by external tools to store and retrieve arbitrary metadata. They are
+      not queryable and should be preserved when modifying objects.
+    type: dict
+  api_key:
+    description:
+    - Token used to connect to the API.
+  cert_file:
+    description:
+    - Path to a certificate used to authenticate with the API.
+    type: path
+  context:
+    description:
+    - The name of a context found in the Kubernetes config file.
+  debug:
+    description:
+    - Enable debug output from the OpenShift helper. Logging info is written to KubeObjHelper.log
+    default: false
+    type: bool
+  force:
+    description:
+    - If set to C(True), and I(state) is C(present), an existing object will updated,
+      and lists will be replaced, rather than merged.
+    default: false
+    type: bool
+  host:
+    description:
+    - Provide a URL for acessing the Kubernetes API.
+  key_file:
+    description:
+    - Path to a key file used to authenticate with the API.
+    type: path
+  kubeconfig:
+    description:
+    - Path to an existing Kubernetes config file. If not provided, and no other connection
+      options are provided, the openshift client will attempt to load the default
+      configuration file from I(~/.kube/config.json).
+    type: path
+  labels:
+    description:
+    - Map of string keys and values that can be used to organize and categorize (scope
+      and select) objects. May match selectors of replication controllers and services.
+    type: dict
+  name:
+    description:
+    - Name must be unique within a namespace. Is required when creating resources,
+      although some resources may allow a client to request the generation of an appropriate
+      name automatically. Name is primarily intended for creation idempotence and
+      configuration definition. Cannot be updated.
+  namespace:
+    description:
+    - Namespace defines the space within each name must be unique. An empty namespace
+      is equivalent to the "default" namespace, but "default" is the canonical representation.
+      Not all objects are required to be scoped to a namespace - the value of this
+      field for those objects will be empty. Must be a DNS_LABEL. Cannot be updated.
+  password:
+    description:
+    - Provide a password for connecting to the API. Use in conjunction with I(username).
+  resource_definition:
+    description:
+    - Provide the YAML definition for the object, bypassing any modules parameters
+      intended to define object attributes.
+    type: dict
+  role_ref_api_group:
+    description:
+    - APIGroup is the group for the resource being referenced
+    aliases:
+    - api_group
+  role_ref_kind:
+    description:
+    - Kind is the type of resource being referenced
+    aliases:
+    - kind
+  role_ref_name:
+    description:
+    - Name is the name of resource being referenced
+  src:
+    description:
+    - Provide a path to a file containing the YAML definition of the object. Mutually
+      exclusive with I(resource_definition).
+    type: path
+  ssl_ca_cert:
+    description:
+    - Path to a CA certificate used to authenticate with the API.
+    type: path
+  state:
+    description:
+    - Determines if an object should be created, patched, or deleted. When set to
+      C(present), the object will be created, if it does not exist, or patched, if
+      parameter values differ from the existing object's attributes, and deleted,
+      if set to C(absent). A patch operation results in merging lists and updating
+      dictionaries, with lists being merged into a unique set of values. If a list
+      contains a dictionary with a I(name) or I(type) attribute, a strategic merge
+      is performed, where individual elements with a matching I(name_) or I(type)
+      are merged. To force the replacement of lists, set the I(force) option to C(True).
+    default: present
+    choices:
+    - present
+    - absent
+  subjects:
+    description:
+    - Subjects holds references to the objects the role applies to.
+    type: list
+  username:
+    description:
+    - Provide a username for connecting to the API.
+  verify_ssl:
+    description:
+    - Whether or not to verify the API server's SSL certificates.
+    type: bool
+requirements:
+- kubernetes == 4.0.0
+'''
+
+EXAMPLES = '''
+'''
+
+RETURN = '''
+api_version:
+  description: Requested API version
+  type: string
+role_binding:
+  type: complex
+  returned: when I(state) = C(present)
+  contains:
+    api_version:
+      description:
+      - APIVersion defines the versioned schema of this representation of an object.
+        Servers should convert recognized schemas to the latest internal value, and
+        may reject unrecognized values.
+      type: str
+    kind:
+      description:
+      - Kind is a string value representing the REST resource this object represents.
+        Servers may infer this from the endpoint the client submits requests to. Cannot
+        be updated. In CamelCase.
+      type: str
+    metadata:
+      description:
+      - Standard object's metadata.
+      type: complex
+    role_ref:
+      description:
+      - RoleRef can reference a Role in the current namespace or a ClusterRole in
+        the global namespace. If the RoleRef cannot be resolved, the Authorizer must
+        return an error.
+      type: complex
+    subjects:
+      description:
+      - Subjects holds references to the objects the role applies to.
+      type: list
+      contains:
+        api_group:
+          description:
+          - APIGroup holds the API group of the referenced subject. Defaults to ""
+            for ServiceAccount subjects. Defaults to "rbac.authorization.k8s.io" for
+            User and Group subjects.
+          type: str
+        kind:
+          description:
+          - Kind of object being referenced. Values defined by this API group are
+            "User", "Group", and "ServiceAccount". If the Authorizer does not recognized
+            the kind value, the Authorizer should report an error.
+          type: str
+        name:
+          description:
+          - Name of the object being referenced.
+          type: str
+        namespace:
+          description:
+          - Namespace of the referenced object. If the object kind is non-namespace,
+            such as "User" or "Group", and this value is not empty the Authorizer
+            should report an error.
+          type: str
+'''
+
+
+def main():
+    try:
+        module = KubernetesAnsibleModule('role_binding', 'v1')
+    except KubernetesAnsibleException as exc:
+        # The helper failed to init, so there is no module object. All we can do is raise the error.
+        raise Exception(exc.message)
+
+    try:
+        module.execute_module()
+    except KubernetesAnsibleException as exc:
+        module.fail_json(msg="Module failed!", error=str(exc))
+
+
+if __name__ == '__main__':
+    main()