Defined Type: wildfly::resource

Defined in:
manifests/resource.pp

Overview

Manages a Wildfly configuration resource: e.g ‘/subsystem=datasources/data-source=MyDS or /subsystem=datasources/jdbc-driver=postgresql`.

Virtually anything in your configuration XML file that can be manipulated using JBoss-CLI could be managed by this defined type.
This define is a wrapper for `wildfly_resource` that defaults to your local Wildfly installation.

Parameters:

  • ensure (Enum[present, absent]) (defaults to: present) —

    Whether the resource should exist (‘present`) or not (`absent`).

  • recursive (Boolean) (defaults to: false) —

    Whether it should manage the resource recursively or not.

  • undefine_attributes (Boolean) (defaults to: false) —

    Whether it should undefine attributes with undef value.

  • content (Hash) (defaults to: {}) —

    Sets the content/state of the target resource.

  • operation_headers (Hash) (defaults to: {}) —

    Sets [operation-headers](docs.jboss.org/author/display/WFLY9/Admin+Guide#AdminGuide-OperationHeaders) (e.g. ‘{ ’allow-resource-service-restart’ => true, ‘rollback-on-runtime-failure’ => false, ‘blocking-timeout’ => 600}‘) to be used when creating/destroying this resource.

  • profile (Optional[String]) (defaults to: undef) —

    Sets the target profile to prefix resource name. Requires domain mode.

  • username (String) (defaults to: $wildfly::mgmt_user['username']) —

    Wildfly’s management user to be used internally.

  • password (String) (defaults to: $wildfly::mgmt_user['password']) —

    The password for Wildfly’s management user.

  • host (String) (defaults to: $wildfly::properties['jboss.bind.address.management']) —

    The IP address or FQDN of the JBoss Management service.

  • port (String) (defaults to: $wildfly::properties['jboss.management.http.port']) —

    The port of the JBoss Management service.

  • secure (Boolean) (defaults to: $wildfly::secure_mgmt_api) —

    Use https port or http port.



18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'manifests/resource.pp', line 18

define wildfly::resource (
  Enum[present, absent] $ensure = present,
  Boolean $recursive            = false,
  Boolean $undefine_attributes  = false,
  Hash $content                 = {},
  Hash $operation_headers       = {},
  Optional[String] $profile     = undef,
  String $username              = $wildfly::mgmt_user['username'],
  String $password              = $wildfly::mgmt_user['password'],
  String $host                  = $wildfly::properties['jboss.bind.address.management'],
  String $port                  = $wildfly::properties['jboss.management.http.port'],
  Boolean $secure               = $wildfly::secure_mgmt_api,
) {
  $profile_path = wildfly::profile_path($profile)

  if $undefine_attributes {
    $attributes = $content
  } else {
    $attributes = delete_undef_values($content)
  }

  if $secure {
    $_port = $wildfly::properties['jboss.management.https.port']
  }
  else {
    $_port = $port
  }

  wildfly_resource { "${profile_path}${title}":
    ensure            => $ensure,
    path              => "${profile_path}${title}",
    username          => $username,
    password          => $password,
    host              => $host,
    port              => $_port,
    secure            => $secure,
    recursive         => $recursive,
    state             => $attributes,
    operation_headers => $operation_headers,
    require           => Service['wildfly'],
  }
}