Add recommended argument_specs

23 files changed, 91 insertions, 3 deletions

diff --git a/roles/acl/meta/argument_specs.yml b/roles/acl/meta/argument_specs.yml
new file mode 100644
index 00000000..6ba10385
--- /dev/null
+++ b/roles/acl/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install acl on Linux distribution"
+    description: "Install acl on Linux distribution"
+    options: {}
diff --git a/roles/ansible/meta/argument_specs.yml b/roles/ansible/meta/argument_specs.yml
index 6f6b6ee8..fa50e661 100644
--- a/roles/ansible/meta/argument_specs.yml
+++ b/roles/ansible/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Install ansible and molecule on Linux distributions"
+    description: "Install ansible and molecule on Linux distributions"
     options:
       ansible_core_default_version:
         type: "str"
diff --git a/roles/bash/meta/argument_specs.yml b/roles/bash/meta/argument_specs.yml
new file mode 100644
index 00000000..7667dbe4
--- /dev/null
+++ b/roles/bash/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install bash on Linux distribution"
+    description: "Install bash on Linux distribution"
+    options: {}
diff --git a/roles/curl/meta/argument_specs.yml b/roles/curl/meta/argument_specs.yml
new file mode 100644
index 00000000..e121efb3
--- /dev/null
+++ b/roles/curl/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install curl on Linux distribution"
+    description: "Install curl on Linux distribution"
+    options: {}
diff --git a/roles/docker/meta/argument_specs.yml b/roles/docker/meta/argument_specs.yml
new file mode 100644
index 00000000..4b32b46e
--- /dev/null
+++ b/roles/docker/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install Docker Engine on Linux distributions"
+    description: "Install Docker Engine on Linux distributions"
+    options: {}
diff --git a/roles/go/meta/argument_specs.yml b/roles/go/meta/argument_specs.yml
index f0eea1bc..9468a5cd 100644
--- a/roles/go/meta/argument_specs.yml
+++ b/roles/go/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Install Go (versions) on Linux distributions"
+    description: "Install Go (versions) on Linux distributions"
     options:
       go_global_version:
         type: "str"
diff --git a/roles/homebrew/meta/argument_specs.yml b/roles/homebrew/meta/argument_specs.yml
new file mode 100644
index 00000000..e275b4fc
--- /dev/null
+++ b/roles/homebrew/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install homebrew package manager on Linux distributions"
+    description: "Install homebrew package manager on Linux distributions"
+    options: {}
diff --git a/roles/hostname/meta/argument_specs.yml b/roles/hostname/meta/argument_specs.yml
index d74f95e5..9576748d 100644
--- a/roles/hostname/meta/argument_specs.yml
+++ b/roles/hostname/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure basic distro hostname"
+    description: "Configure basic distro hostname"
     options:
       hostname:
         type: "str"
diff --git a/roles/locales/meta/argument_specs.yml b/roles/locales/meta/argument_specs.yml
index 606f8be3..99bcf5f9 100644
--- a/roles/locales/meta/argument_specs.yml
+++ b/roles/locales/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure the linux distro locales"
+    description: "Configure the linux distro locales"
     options:
       locales:
         type: "list"
diff --git a/roles/network/meta/argument_specs.yml b/roles/network/meta/argument_specs.yml
index 86df33c6..c69555d7 100644
--- a/roles/network/meta/argument_specs.yml
+++ b/roles/network/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure basic distro networking features"
+    description: "Configure basic distro networking features"
     options:
       network_wifi_ssid:
         type: "str"
diff --git a/roles/password_policy/meta/argument_specs.yml b/roles/password_policy/meta/argument_specs.yml
index 8c312a8c..1b21e3aa 100644
--- a/roles/password_policy/meta/argument_specs.yml
+++ b/roles/password_policy/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure the linux distro password policy"
+    description: "Configure the linux distro password policy"
     options:
       password_policy_enabled:
         type: "bool"
diff --git a/roles/pihole/meta/argument_specs.yml b/roles/pihole/meta/argument_specs.yml
index a2f9976f..5ed8d528 100644
--- a/roles/pihole/meta/argument_specs.yml
+++ b/roles/pihole/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure pihole on supported devices"
+    description: "Configure pihole on supported devices"
     options:
       pihole_password:
         type: "str"
diff --git a/roles/podman/meta/argument_specs.yml b/roles/podman/meta/argument_specs.yml
new file mode 100644
index 00000000..21aad33d
--- /dev/null
+++ b/roles/podman/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install Podman container engine on Linux distributions"
+    description: "Install Podman container engine on Linux distributions"
+    options: {}
diff --git a/roles/python/meta/argument_specs.yml b/roles/python/meta/argument_specs.yml
index ef13b7c8..b63ec46b 100644
--- a/roles/python/meta/argument_specs.yml
+++ b/roles/python/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Install pyenv, pipx and python (versions) on Linux distributions"
+    description: "Install pyenv, pipx and python (versions) on Linux distributions"
     options:
       python_global_version:
         type: "str"
diff --git a/roles/ssh/meta/argument_specs.yml b/roles/ssh/meta/argument_specs.yml
index ec1a6942..7581a905 100644
--- a/roles/ssh/meta/argument_specs.yml
+++ b/roles/ssh/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure distro ssh with hardening"
+    description: "Configure distro ssh with hardening"
     options:
       username:
         type: "str"
diff --git a/roles/sudo/meta/argument_specs.yml b/roles/sudo/meta/argument_specs.yml
new file mode 100644
index 00000000..89148dc9
--- /dev/null
+++ b/roles/sudo/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install sudo on Linux distributions"
+    description: "Install sudo on Linux distributions"
+    options: {}
diff --git a/roles/sudo/meta/main.yml b/roles/sudo/meta/main.yml
index cadb8d3f..0c58f04a 100644
--- a/roles/sudo/meta/main.yml
+++ b/roles/sudo/meta/main.yml
@@ -2,7 +2,7 @@
 dependencies: []
 galaxy_info:
   author: "a14m"
-  description: "Install sudo"
+  description: "Install sudo on Linux distributions"
   company: "kartoffeln.work GmbH."
   license: "MIT"
   min_ansible_version: "2.18"
diff --git a/roles/systemd/meta/argument_specs.yml b/roles/systemd/meta/argument_specs.yml
new file mode 100644
index 00000000..51706a69
--- /dev/null
+++ b/roles/systemd/meta/argument_specs.yml
@@ -0,0 +1,6 @@
+---
+argument_specs:
+  main:
+    short_description: "Install systemd on Linux distributions"
+    description: "Install systemd on Linux distributions"
+    options: {}
diff --git a/roles/systemd/meta/main.yml b/roles/systemd/meta/main.yml
index 4e7749b5..23f8e9d0 100644
--- a/roles/systemd/meta/main.yml
+++ b/roles/systemd/meta/main.yml
@@ -2,7 +2,7 @@
 dependencies: []
 galaxy_info:
   author: "a14m"
-  description: "Install systemd"
+  description: "Install systemd on Linux distributions"
   company: "kartoffeln.work GmbH."
   license: "MIT"
   min_ansible_version: "2.18"
diff --git a/roles/timezone/meta/argument_specs.yml b/roles/timezone/meta/argument_specs.yml
index c4be9397..bb613463 100644
--- a/roles/timezone/meta/argument_specs.yml
+++ b/roles/timezone/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure the linux distro timezone"
+    description: "Configure the linux distro timezone"
     options:
       timezone:
         type: "str"
diff --git a/roles/user/meta/argument_specs.yml b/roles/user/meta/argument_specs.yml
index 5f4b1fd4..5d2e4b9b 100644
--- a/roles/user/meta/argument_specs.yml
+++ b/roles/user/meta/argument_specs.yml
@@ -1,6 +1,8 @@
 ---
 argument_specs:
   main:
+    short_description: "Configure user and user public keys"
+    description: "Configure user and user public keys"
     options:
       username:
         type: "str"
diff --git a/roles/user/meta/main.yml b/roles/user/meta/main.yml
index 50cb8081..548316a8 100644
--- a/roles/user/meta/main.yml
+++ b/roles/user/meta/main.yml
@@ -4,7 +4,7 @@ dependencies:
   - role: "sudo"
 galaxy_info:
   author: "a14m"
-  description: "Configure user and sudo"
+  description: "Configure user and user public keys"
   company: "kartoffeln.work GmbH."
   license: "MIT"
   min_ansible_version: "2.18"
diff --git a/roles/wg_portal/meta/argument_specs.yml b/roles/wg_portal/meta/argument_specs.yml
new file mode 100644
index 00000000..a6fef116
--- /dev/null
+++ b/roles/wg_portal/meta/argument_specs.yml
@@ -0,0 +1,18 @@
+---
+argument_specs:
+  main:
+    short_description: "Install and configure wg-portal VPN web interface manager"
+    description: "Install and configure wg-portal VPN web interface manager"
+    options:
+      wg_portal_version:
+        description: "Version of wg-portal to install"
+        type: "str"
+        default: "latest"
+      wg_portal_port:
+        description: "Port for wg-portal web interface"
+        type: "str"
+        default: "8080"
+      wg_portal_password:
+        description: "Password hash for wg-portal authentication"
+        type: "str"
+        default: "{{ ('changeme' | hash('sha256') | hash('sha256'))[:64] }}"
\ No newline at end of file