Feature s3 repository extension (#366)
Signed-off-by: Michael Hirsch <michael.hirsch@bosch-si.com>
This commit is contained in:
committed by
Kai Zimmermann
parent
11fa4469dd
commit
edbadc4002
@@ -0,0 +1,33 @@
|
||||
# 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](http://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html).
|
||||
|
||||
You can exchange the credentials provider by overwriting the `AWSCredentialsProvider` bean (see S3RepositoryAutoConfiguration).
|
||||
Reference in New Issue
Block a user