Skip to content

Gradle plugin for working with mock AWS endpoints using LocalStack.

License

Notifications You must be signed in to change notification settings

Nike-Inc/gradle-localstack

Repository files navigation

gradle-localstack

Gradle plugin for setting up mock AWS endpoints during test and development using LocalStack.

This plugin provides a number of helpful tasks for creating and working with mock AWS resources during test and development using LocalStack as well as tasks for easily integrating Spring Boot with LocalStack using simple Gradle DSL.

Use the plugin to easily create and interact with all of the AWS resources required by your application locally and provide end-to-end integration tests that run on your local machine without the need for a live AWS environment.

Getting Started

The plugin can be applied with either the plugin or legacy buildscript DSL. For more information on applying the plugin and available plugin versions please refer to the Gradle Plugin Portal.

Applying the Plugin with Plugin DSL

plugins {
    id "com.nike.pdm.localstack"    version "1.0.0"
}

Applying the Plugin with Legacy Buildscript DSL

buildscript {
  repositories {
    maven {
      url "https://plugins.gradle.org/m2/"
    }
  }
  dependencies {
    classpath "gradle.plugin.com.nike.pdm.localstack:gradle-localstack-plugin:1.0.0"
  }
}

apply plugin: "com.nike.pdm.localstack"

Documentation

For detailed documentation on this plugin and its features please refer to the LocalStack Gradle Plugin User Guide.

Example

Please refer to the included sample project, gradle-localstack-plugin-example, for a simple demonstration on applying and configuring the plugin.

License

Copyright 2020 - Present, Nike, Inc. All rights reserved.

This source code is licensed under the Apache-2.0 license found in the LICENSE file in the root directory of this source tree.