Skip to content

Simple Java library which helps to control virtual machines in cloud environments

License

Notifications You must be signed in to change notification settings

wildfly-extras/sunstone

Repository files navigation

Sunstone

Simple library which helps to control virtual machines in cloud environments. It's aimed mainly to testing WildFly application server.

Name: Sunstone is a crystal that was supposedly used by Vikings to navigate in cloudy weather.

Motivation

Why?

Why yet another library?
Because clouds exist. And they are many! Moreover, everybody loves new libraries, of course.

The library is here to simplify test development for new clouds.

What?

What does it bring to me?
One view to rule them all.

  • United approach for all supported cloud providers
  • Deploy resources to 3rd party cloud with Azure ARM templates, AWS CloudFormation Templates, ...
  • Inject SDK clients, Management clients, hostnames of created resources, ...
  • Possibility to control products (e.g. WildFly nodes with Creaper)
  • JUnit5 test framework support

How?

Depends on the cloud you are working with. For every supported cloud, there is a module that brings all API and support you need. The flow always follow (even if you combine two cloud modules in one single test):

  1. Cloud deployment - creating cloud resources

  2. Setup task

  3. Deployment operation

  4. Inject static test class fields

  5. Inject non-static test instance fields

      1. are done in BeforeAllCallback. 5. in the postProcessTestInstance
Configuration

Configuration is done by setting properties:

  • In sunstone.properties file located in your resources folder.
  • As system variable.
  • As environment variable.

Nested expressions and their resolution to other properties are supported, i.e.

${my.property-${different.property}}

Sunstone Config properties and their resolution is backed by SmallRye Config so most of SR Config capabilities are also supported.

User stories

For more information about specific clouds, see:

Sunstone deploys and manages lifecycle of cloud resources - deploys resources before tests and deletes them once tests are finished. Various deploy methods are supported.

See:

Setup task

'@Setup' annotation on a test class defines setup tasks that will be run before the first WildFly deployment. teardown method will be run after the last WildFly deployment is undeployed. Setup task class must extend AbstractSetupTask class. You can also inject static and non-static field that follows same principles as described in injection subchapter

@Setup(SetupTest.StaticClassTask.class)
public class SetupTest {

    @Test
    public void test() {
        // test logic
    }

    static class StaticClassTask extends AbstractSetupTask {
        @Override
        public void setup() throws Exception {
            // configure WildFly or cloud resources
        }

        @Override
        public void teardown() throws Exception {
            // tear down the configuration
        }
    }
}
WildFly deployment

WildFly deploy operation is specific to the type of resources WildFly is running on. The archive that you want to be deployed, you must use @Deployment annotation on a static method returning the archive. Supported return types:

  • File (local)
  • Path (local)
  • Archive (Shrinkwrap)
  • InputStream

The method must be annotated by cloud-specific annotation that identifies the cloud resource. The annotations come from cloud specific Sunstone modules.

See:

Injection

Sunstone supports injection of several resources, i.e. hostname of resources (Azure Web app, AWS EC2 instance, ... ). The logic is that if you want to inject a particular field od particular type, you need to identify the cloud resource. I.e. you want to inject a hostname. The type must be Hostname. You also need to annotate the field with cloud-specific annotation that identify such resources. The annotations come from cloud specific Sunstone modules.

See:

Logging

SLF4J is used as a logging facade, so you have to have the appropriate adapter on the classpath. If you use Logback, you don't have to do anything. For other loggers, see the SLF4J manual.

The loggers are called sunstone.*, short and clear. (For example: sunstone.core)

log downloader [WIP: azure only]

In the event of a deployment failure, logs are automatically downloaded and stored within the MODULE/target/logs/*.log files. Please note that this feature is currently a work in progress and is available for Azure environments only.

License

About

Simple Java library which helps to control virtual machines in cloud environments

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages