kowabunga.cloud.kahuna role – Install, configure, and start Kahuna and Koala

Note

This role is part of the kowabunga.cloud collection (version 0.0.1).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install kowabunga.cloud.

To use it in a playbook, specify: kowabunga.cloud.kahuna.

Entry point main – Install, configure, and start Kahuna and Koala

Synopsis

  • Install, configure, and start Kowabunga Kahuna orchestrator and Koala WebUI.

Parameters

Parameter

Comments

kowabunga_kahuna_admin_email

string / required

Email address for Kahuna to send emails from

kowabunga_kahuna_api_key

string / required

Kahuna master API key used to bootstrap system.

Recommended to be safe and encrypted into Ansible Vault or SOPS.

Recommended not to be used once users accounts and nominative admin keys have been issued.

kowabunga_kahuna_bootstrap_pubkey

string / required

Default SSH public key to be associated to bootstrap user when instances are created.

kowabunga_kahuna_bootstrap_user

string / required

Default username to be associated to created instance when boostraped.

Can be tune-in per project

kowabunga_kahuna_cache_enabled

boolean

Define whether Kahuna must cache database requests.

Cache entries are flushed when resources are updated.

Choices:

  • false

  • true ← (default)

kowabunga_kahuna_cache_size_mb

integer

Kahuna cache size (in MB), when enabled.

Default: 16

kowabunga_kahuna_cache_ttl_minutes

integer

Kahuna cache time-to-live (TTL), when enabled.

Cache entries are automatically flushed after TTL interval.

Default: 15

kowabunga_kahuna_cache_type

string

Type of database cache to be used ny Kahuna

Choices:

  • "memory" ← (default)

kowabunga_kahuna_db_name

string

MongoDB database name used by Kahuna.

Default: "kowabunga"

kowabunga_kahuna_db_uri

string

MongoDB connection URI used by Kahuna to access database.

Default: "mongodb://127.0.0.1:27017/?directConnection=true"

kowabunga_kahuna_http_address

string

IPv4 address for Kahuna to listen to.

Default: "Instance's private interface IPv4 address."

kowabunga_kahuna_http_port

integer

Port number for Kahuna to listen from.

Default: 8080

kowabunga_kahuna_jwt_lifetime_hours

integer

Lifetime (hours) of issued JWT tokens.

High frequency enforces token generation, consuming more resources.

Low frequency can causes security issues if token get compromised.

Default: 24

kowabunga_kahuna_jwt_signature

string / required

Secret key used by Kahuna to issue JWT token.

Recommended to be safe and encrypted into Ansible Vault or SOPS.

kowabunga_kahuna_loglevel

string

Kahuna server log level.

Choices:

  • "INFO" ← (default)

  • "DEBUG"

  • "WARNING"

  • "CRITICAL"

kowabunga_kahuna_smtp_from

string / required

Email address for Kahuna to send emails notifications from.

kowabunga_kahuna_smtp_host

string

SMTP host to be used by Kahuna to send email notifications.

Default: "smtp.acme.com"

kowabunga_kahuna_smtp_password

string / required

SMTP password to be used by Kahuna to send email notifications.

kowabunga_kahuna_smtp_port

integer

SMTP host to be used by Kahuna to send email notifications.

Default: 587

kowabunga_kahuna_smtp_username

string / required

SMTP username to be used by Kahuna to send email notifications.

kowabunga_koala_enabled

boolean

Defines whether Koala WebUI must be deployed.

Choices:

  • false

  • true ← (default)

kowabunga_public_url

string / required

Public URL the server is exposed to.