hawkbit/extensions/hawkbit-extension-artifact-repository-s3

Eclipse hawkBit - Artifact Repository AWS S3

HawkBit Artifact Repository is a library for storing binary artifacts and metadata into the AWS S3 service.

Using Artifact Repository S3 Extension

The module contains a spring-boot autoconfiguration for easily integration into spring-boot projects. For using this extension in the hawkbit-example-application you just need to add the maven dependency.

<dependency>
  <groupId>org.eclipse.hawkbit</groupId>
  <artifactId>hawkbit-extension-artifact-repository-s3</artifactId>
  <version>${project.version}</version>
</dependency>

Configuration of the S3 Extension

Bucket

All files are stored in a bucket configured via property org.eclipse.hawkbit.repository.s3.bucketName (see S3RepositoryProperties). The name of the object stored in the S3 bucket is the SHA1-hash of the binary file.

S3 Credentials

The extension is using the DefaultAWSCredentialsProviderChain class which looks for credentials in this order:

1. Environment variables (AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY)
2. Java system properties (aws.accessKeyId and aws.secretKey)
3. Default credential profile file (~/.aws/credentials)
4. Amazon ECS container credentials
5. Instance profile credentials

For more information check the Amazon credentials guide.

You can exchange the credentials provider by overwriting the AWSCredentialsProvider bean (see S3RepositoryAutoConfiguration).