Improve the parameters of the Mastodon role

roles/mastodon/meta/argument_specs.yml

@@ -4,25 +4,46 @@ argument_specs:
     options:
       rails_log_level:
         type: str
+        choices: ["debug", "info", "warn", "error", "fatal", "unknown"]
+        description: Determines the amount of logs generated by Mastodon for the web and Sidekiq processes.
       default_locale:
         type: str
+        choices: [
+          "ar", "ast", "bg", "bn", "br", "ca", "co", "cs", "cy", "da", "de", "el", "en", "eo", "es",
+          "es-AR", "et", "eu", "fa", "fi", "fr", "ga", "gl", "he", "hi", "hr", "hu", "hy", "id", "io",
+          "is", "it", "ja", "ka", "kab", "kk", "kn", "ko", "lt", "lv", "mk", "ml", "mr", "ms", "nl",
+          "nn", "no", "oc", "pl", "pt-BR", "pt-PT", "ro", "ru", "sk", "sl", "sq", "sr", "sr-Latn", "sv",
+          "ta", "te", "th", "tr", "uk", "ur", "vi", "zh-CN", "zh-HK", "zh-TW",
+        ]
+        description:
+          - By default, Mastodon will automatically detect the visitor’s language from browser headers.
+          - If you are running a language-specific or regional server, that behavior may mislead visitors who do not speak your language.
+          - For this reason, you may want to set this variable to a specific language.
       local_domain:
         type: str
         required: true
+        description: This is the unique identifier of your server in the network. It cannot be safely changed later.
       alternate_domains:
         type: str
+        description:
+          - If you have multiple domains, this setting will allow Mastodon to recognize itself.
+          - Separate the domains by commas.
       vapid_public_key:
         type: str
         required: true
+        description: Generate with rake mastodon:webpush:generate_vapid_key. Changing it will break push notifications.
       vapid_private_key:
         type: str
         required: true
+        description: Generate with rake mastodon:webpush:generate_vapid_key. Changing it will break push notifications.
       otp_secret:
         type: str
         required: true
+        description: Generate with rake secret. Changing it will break two-factor authentication.
       secret_key_base:
         type: str
         required: true
+        description: Generate with rake secret. Changing it will break all active browser sessions.
       # Database
       db_host:
         type: str
@@ -34,22 +55,20 @@ argument_specs:
         type: int
       db_pass:
         type: str
-        required: true
       # SMTP
       smtp_server:
         type: str
-        required: true
       smtp_port:
         type: int
       smtp_enable_starttls:
         type: str
+        choices: ["auto", "always", "never"]
       smtp_login:
         type: str
       smtp_from_address:
         type: str
       smtp_password:
         type: str
-        required: true
       # S3
       s3_enabled:
         type: bool
@@ -90,4 +109,3 @@ argument_specs:
         type: str
       ldap_password:
         type: str
-        required: true

roles/mastodon/vars/main.yml

@@ -8,12 +8,14 @@ db_host: postgresql
 db_user: mastodon
 db_name: mastodon
 db_port: 5432
+db_pass: ""
 
 smtp_server: ""
 smtp_port: 587
+smtp_enable_starttls: always
 smtp_login: ""
 smtp_from_address: ""
-smtp_enable_starttls: always
+smtp_password: ""
 
 s3_enabled: false
 s3_endpoint: ""
@@ -29,3 +31,4 @@ ldap_port: 389
 ldap_method: start_tls
 ldap_base: ""
 ldap_bind_dn: ""
+ldap_password: ""