wildfly (31) Versions 2.5.1 Follow13

Installs/Configures wildfly

Policyfile

Berkshelf

Knife

cookbook 'wildfly', '~> 2.5.1', :supermarket

cookbook 'wildfly', '~> 2.5.1'

knife supermarket install wildfly

knife supermarket download wildfly

README

Dependencies

Quality 50%

Wildfly Cookbook

Cookbook to deploy the WildFly Java Application Server

Provides resources for installing/configuring WildFly and managing WildFly service instances for use in wrapper cookbooks. Installs WildFly from tarball and installs the appropriate configuration for your platform's init system.

Requirements

Platforms

RHEL and derivatives
Ubuntu

Chef

Chef 12.19+

Usage

This cookbook has recently been rewritten to be resource-driven. It was a large undertaking and breaks old behavior, hence the major version bump. The API-driven configuration and deployment resources are much faster to converge.

The old recipes were kept around for similar, legacy behavior, but using the resources directly in your wrapper cookbook will yield more flexibility.

Example wrapper cookbook scenarios are available in the test cookbook, under test/fixtures/cookbooks/test

Attributes

node['wildfly']['version'] - Specify the version of Wildfly
node['wildfly']['url'] - URL to WildFly tarball
node['wildfly']['checksum'] - SHA256 hash of said tarball

Recipes

::default - Installs WildFly and any enabled connectors.
::install - Installs WildFly using the wildfly resource
::mysql_connector - Installs MySQL Connector/J
::postgres_connector - Installs PostgreSQL Java connector

Resource Providers

WildFly

Installs and configures WildFly.

wildfly_wildfly 'wildfly' do
  mode 'standalone' # => WildFly Mode
  config 'standalone-full.xml' # => The WildFly Configuration File
  base_dir '/opt/wildfly' # => Directory to install WildFly to
  service_user 'wildfly'
  service_group 'wildfly'
  provision_user true # => Whether to create the WildFly service user/group
  create_mgmt_user true # => Provision a random, secure user for API interactions
  url 'http://.../wildfly.tar.gz' # URL to WildFly tarball to download
  checksum 'SHA256_CHECKSUM' # WildFly Tarball Checksum
  version '1.2.3' # Version of WildFly (Should correspond to URL)
end

Accessor Properties

bind_management_http - the HTTP port for the Management Interface & API

User

A resource for deploying users to WildFly service instances.

wildfly_user 'my_wildfly_user' do
  password 'MySecretPassword' # The user's password, maybe pull it from Vault or ParameterStore
  roles ['Administrator', 'SuperUser'] # String or Array of groups/roles to map to the user: Default: []
  realm 'ManagementRealm' # ManagementRealm or ApplicationRealm
  instance 'wildfly' # Choose the WildFly service instance the user is associated with.  * wildcard can be used to deploy globally.
end

Resource

Flexible resource which allows provisioning of attributes and their parameters via the WildFly Management API. This should be used over other resources as it affords more flexibility.

wildfly_resource 'Syslog Handler' do
  path ['subsystem', 'logging', 'syslog-handler', 'SYSLOG']
  parameters 'app-name' => 'TEST',
             'enabled'  => true,
             'hostname' => 'localhost',
             'level'    => 'ALL',
             'port'     => 514,
             'server-address' => 'test.syslog.local',
             'syslog-format'  => 'RFC5424'
  action :create
end

Deploy API

Resource to deploy applications via the API

# => URL-Based Deployment
wildfly_deploy_api 'Sample' do
  deploy_name 'sample-v1'
  runtime_name 'sample.war'
  parameters 'url' => 'https://github.com/apcera/sample-apps/raw/master/example-java-war/sample.war'
end

# => File-Based Deployment
myapp = remote_file 'helloworld' do
  source 'https://github.com/efsavage/hello-world-war/raw/master/dist/hello-world.war'
  path ::File.join(Chef::Config[:file_cache_path], 'hello-world.war')
  mode '0644'
  action :create
end

wildfly_deploy_api 'HelloWorld File Deployment' do
  deploy_name "HelloWorld-file-V1"
  runtime_name 'helloworld-file.war'
  parameters 'url' => 'file://' + myapp.path
end

Legacy Resources

These will be deprecated in the future. The wildfly_resource resource can do everything these can, and via the much faster Management API. The deploy_api resource will replace the deploy resource as well.

Datasource

wildfly_datasource 'example' do
  jndiname 'java:jboss/datasource/example'
  drivername 'some-jdbc-driver'
  connectionurl 'jdbc:some://127.0.0.1/example'
  username 'db_username'
  password 'db_password'
  sensitive false
end

Deploy

Allows you to deploy JARs and WARs via chef

From a URL

wildfly_deploy 'jboss.jdbc-driver.sqljdbc4_jar' do
      url 'http://artifacts.company.com/artifacts/mssql-java-driver/sqljdbc4.jar'
end

From File

wildfly_deploy 'jboss.jdbc-driver.sqljdbc4_jar' do
      path '/opt/resources/sqljdb4.jar'
end

With Automated Update

Requires a common runtime_name and version-specific name
ruby wildfly_deploy 'my-app-1.0.war' do url 'http://artifacts.company.com/artifacts/my-app.1.0.war' runtime_name 'my-app.war' end

Undeploy

Use :disable to keep the contents, and :enable to re-deploy previously kept contents
ruby wildfly_deploy 'jboss.jdbc-driver.sqljdbc4_jar' do action :remove end

Attribute LWRP

Allows you to set an attribute in the server config

Example

<server name="default-server">
  <http-listener name="default" socket-binding="http" max-post-size="20971520"/>
  <host name="default-host" alias="localhost">

Adjust `max-post-size`

wildfly_attribute 'max-post-size' do
   path '/subsystem=undertow/server=default-server/http-listener=default'
   parameter 'max-post-size'
   value '20971520L'
   notifies :restart, 'wildfly[wildfly]', :delayed
end

Add Attribute

wildfly_attribute 'max-post-size' do
   path '/subsystem=mail/mail-session="postbox"'
   parameter 'jndi-name="java:/mail/postbox",debug=true'
   action :add
end

Property LWRP

Allows you to set or delete system properties in the server config. (Supported Actions: :set, :delete)

wildfly_property 'Database URL' do
   property 'JdbcUrl'
   value 'jdbc:mysql://1.2.3.4:3306/testdb'
   action :set
   notifies :restart, 'wildfly[wildfly]', :delayed
end

Authors

Author:: Brian Dwyer - Intelligent Digital Services

Contributors

Contributor:: Hugo Trippaers

Contributor:: Ian Southam

Dependent cookbooks

systemd >= 0.0.0

Contingent cookbooks

Collaborator Number Metric

2.5.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

2.5.1 passed this metric

Foodcritic Metric

2.5.1 passed this metric

No Binaries Metric

2.5.1 passed this metric

Testing File Metric

2.5.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

2.5.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

wildfly (31) Versions 2.5.1 2.5.1 2.5.0 2.4.0 2.3.0 2.2.0 2.1.0 2.0.1 2.0.0 1.1.0 1.0.1 1.0.0 0.4.3 0.4.2 0.4.0 0.2.0 0.1.19 0.1.18 0.1.17 0.1.16 0.1.15 0.1.14 0.1.13 0.1.12 0.1.11 0.1.10 0.1.9 0.1.8 0.1.7 0.1.6 0.1.5 0.1.4 Follow13

Wildfly Cookbook

Requirements

Platforms

Chef

Usage

Attributes

Recipes

Resource Providers

WildFly

Accessor Properties

User

Resource

Deploy API

Legacy Resources

Datasource

Deploy

From a URL

From File

With Automated Update

Undeploy

Attribute LWRP

Example

Adjust max-post-size

Add Attribute

Property LWRP

Authors

Contributors

Dependent cookbooks

Contingent cookbooks

Collaborator Number Metric 2.5.1 failed this metric Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric 2.5.1 passed this metric

Foodcritic Metric 2.5.1 passed this metric

No Binaries Metric 2.5.1 passed this metric

Testing File Metric 2.5.1 failed this metric Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric 2.5.1 failed this metric Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Details

Updated February 11, 2021 Created on May 7, 2014

Supported Platforms

License

Required Chef Infra Client

wildfly (31) Versions 2.5.1 Follow13

Adjust `max-post-size`

Collaborator Number Metric

2.5.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

2.5.1 passed this metric

Foodcritic Metric

2.5.1 passed this metric

No Binaries Metric

2.5.1 passed this metric

Testing File Metric

2.5.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

2.5.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number