diff --git a/plugins/modules/consul_acl_bootstrap.py b/plugins/modules/consul_acl_bootstrap.py index 9c955ff..e452c59 100644 --- a/plugins/modules/consul_acl_bootstrap.py +++ b/plugins/modules/consul_acl_bootstrap.py @@ -11,11 +11,11 @@ module: ednz_cloud.hashistack.consul_acl_bootstrap short_description: Bootstraps ACL for a Consul cluster. -version_added: "1.0.0" +version_added: "0.1.0" description: - This module bootstraps ACL (Access Control List) for a Consul cluster. It performs the ACL bootstrap operation, - creating the initial tokens needed for secure communication within the cluster. + creating the initial tokens needed for secure communication within the cluster. options: api_addr: @@ -40,10 +40,10 @@ author: EXAMPLES = r""" # Example: Bootstrap ACL for a Consul cluster - name: Bootstrap ACL for Consul cluster - ednz_cloud.hashistack.consul_acl_bootstrap: - api_addr: 127.0.0.1 - scheme: http - port: 8500 + ednz_cloud.hashistack.consul_acl_bootstrap: + api_addr: 127.0.0.1 + scheme: http + port: 8500 """ RETURN = r""" diff --git a/plugins/modules/nomad_acl_bootstrap.py b/plugins/modules/nomad_acl_bootstrap.py index 24b4a69..5265ae8 100644 --- a/plugins/modules/nomad_acl_bootstrap.py +++ b/plugins/modules/nomad_acl_bootstrap.py @@ -60,15 +60,15 @@ state: type: dict returned: always sample: - - AccessorID: "b780e702-98ce-521f-2e5f-c6b87de05b24", - - SecretID: "3f4a0fcd-7c42-773c-25db-2d31ba0c05fe", - - Name: "Bootstrap Token", - - Type: "management", - - Policies: null, - - Global: true, - - CreateTime: "2017-08-23T22:47:14.695408057Z", - - CreateIndex: 7, - - ModifyIndex: 7 + - AccessorID: "b780e702-98ce-521f-2e5f-c6b87de05b24", + - SecretID: "3f4a0fcd-7c42-773c-25db-2d31ba0c05fe", + - Name: "Bootstrap Token", + - Type: "management", + - Policies: null, + - Global: true, + - CreateTime: "2017-08-23T22:47:14.695408057Z", + - CreateIndex: 7, + - ModifyIndex: 7 """ from ansible.module_utils.basic import AnsibleModule diff --git a/plugins/modules/vault_init.py b/plugins/modules/vault_init.py index 2434647..c95d17b 100644 --- a/plugins/modules/vault_init.py +++ b/plugins/modules/vault_init.py @@ -11,11 +11,13 @@ module: ednz_cloud.hashistack.vault_init short_description: Manages the initialization of HashiCorp Vault. +version_added: "0.1.0" + description: - This module initializes HashiCorp Vault, ensuring that it is securely set up for use. requirements: - - C(hvac) (L(Python library,https://hvac.readthedocs.io/en/stable/overview.html)) + - C(hvac) (L(Python library,https://hvac.readthedocs.io/en/stable/overview.html)) options: api_url: diff --git a/plugins/modules/vault_unseal.py b/plugins/modules/vault_unseal.py index 16268d2..65b11ab 100644 --- a/plugins/modules/vault_unseal.py +++ b/plugins/modules/vault_unseal.py @@ -7,66 +7,70 @@ __metaclass__ = type DOCUMENTATION = r""" --- -module: my_test +module: ednz_cloud.hashistack.vault_unseal -short_description: This is my test module +short_description: Unseals a Vault cluster. -# If this is part of a collection, you need to use semantic versioning, -# i.e. the version is of the form "2.5.0" and not "2.4". -version_added: "1.0.0" +version_added: "0.1.0" -description: This is my longer description explaining my test module. +description: + - This module unseals a Vault cluster by submitting the necessary unseal keys. It checks whether the Vault is sealed and performs the unseal operation if needed. The response will reflect the state after the last unseal key is submitted. + +requirements: +- C(hvac) (L(Python library,https://hvac.readthedocs.io/en/stable/overview.html)) options: - name: - description: This is the message to send to the test module. + api_url: + description: The URL of the Vault API. required: true type: str - new: - description: - - Control to demo if the result of this module is changed or not. - - Parameter description can be a list as well. + tls_verify: + description: Whether to verify TLS certificates. required: false type: bool -# Specify this value according to your collection -# in format of namespace.collection.doc_fragment_name -# extends_documentation_fragment: -# - my_namespace.my_collection.my_doc_fragment_name + default: true + key_shares: + description: List of unseal keys required to unseal the Vault. + required: false + type: list + default: [] author: - - Your Name (@yourGitHubHandle) + - Bertrand Lanson (@ednz_cloud) """ EXAMPLES = r""" -# Pass in a message -- name: Test with a message - my_namespace.my_collection.my_test: - name: hello world +# Example: Unseal a Vault cluster +- name: Unseal Vault cluster + ednz_cloud.hashistack.vault_unseal: + api_url: "https://127.0.0.1:8200" + tls_verify: true + key_shares: + - "key1" + - "key2" + - "key3" -# pass in a message and have changed true -- name: Test with a message and changed output - my_namespace.my_collection.my_test: - name: hello world - new: true - -# fail the module -- name: Test failure of the module - my_namespace.my_collection.my_test: - name: fail me +# Example: Unseal Vault cluster with no TLS verification +- name: Unseal Vault cluster without TLS verification + ednz_cloud.hashistack.vault_unseal: + api_url: "https://127.0.0.1:8200" + tls_verify: false + key_shares: + - "key1" + - "key2" """ RETURN = r""" -# These are examples of possible return values, and in general should use other names for return values. -original_message: - description: The original name param that was passed in. - type: str +state: + description: Information about the state of the Vault unseal operation. + type: dict returned: always - sample: 'hello world' -message: - description: The output message that the test module generates. - type: str - returned: always - sample: 'goodbye' + sample: + sealed: true, + t: 3, + n: 5, + progress: 2, + version: "0.6.2" """ from ansible.module_utils.basic import AnsibleModule import traceback