Skip to content

Offers a JSON-based, RESTful API designed to manage storage contexts for organizations and spaces.

License

Notifications You must be signed in to change notification settings

EFS-OpenSource/superb-data-kraken-storagemanager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StorageManager

License Java Version Spring Boot Version

SDK LOGO
A data platform for everyone


About

The StorageManager is a component of the Superb Data Kraken Platform (SDK). It offers a JSON-based, RESTful API designed to manage storage contexts for organizations and spaces.

It serves as an interface to the underlying cloud storage system and manages the creation and removal of the storage context, which consists of all necessary storage resources (like storage accounts or buckets) essential for spaces and organizations to provide storage capabilities.

This includes the management of storage like Azure Blob Storage or an S3 storage like the Object Storage Service OBS for Open Telekom Cloud or any other underlying cloud storage used.

For a more detailed understanding of the broader context of the platform this project is used in, refer to the architecture documentation.

For instructions on how to deploy the StorageManager on an instance of the SDK, refer to the installation instructions. Refer to index.md for more detailed but deployment specific documentation.

Getting Started

Follow the instructions below to set up a local copy of the project for development and testing.

Prerequisites

  • jdk >= 17
  • Maven 3.6.x (if you're not using the Maven wrapper)
  • A running OIDC/OAuth2 provider instance
  • sdk-common package

Setup

To set up your local environment for development and testing, follow these steps:

  1. Clone the repository:
    git clone https://github.com/EFS-OpenSource/superb-data-kraken-storagemanager.git
    cd superb-data-kraken-storagemanager
  2. Set up the service configuration:
    cp src/main/resources/application-local-template.yml src/main/resources/application-local.yaml
    Configure the application-local.yaml file based on your local development setup. The OIDC provider instance needs to be configured correctly for the storagemanager to run as expected.
  3. Run the service:
    ./mvnw spring-boot:run -Dspring-boot:run.profiles=local
  4. After successful setup, you can test the service using the auto-generated API documentation at:
    https://localhost:8093/storagemanager/swagger-ui/index.html
    
    

Configuration

  • sdk.oauth2.config-url: Specifies the URL pointing to the OpenID Connect discovery document. This URL provides essential configuration details for OAuth2 and OpenID Connect operations, enabling dynamic discovery of authentication server endpoints and supported features. It's instrumental in configuring the OAuth2-based security settings within the Spring Boot application's security plugin.
  • Replace all placeholders enclosed in $(), e.g.:
    • REALM: the specific realm set up with the openid connect (oidc) provider.
    • CLIENT_ID: the unique identifier for the service account that the service utilizes.

Usage

Here are the essential commands you'll need to use the service:

  • Build the service:
    ./mvnw package
  • Executing the tests alone:
    ./mvnw test
  • Run the storagemanager:
    ./mvnw spring-boot:run -Dspring-boot:run.profiles=local
  • Build the service Docker image:
    docker build -t sdk/storagemanager .
    

Contributing

See the Contribution Guide.

Changelog

See the Changelog.

About

Offers a JSON-based, RESTful API designed to manage storage contexts for organizations and spaces.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published