gregwhitaker / proteus-s3upload-example

Example of streaming upload to S3 using Netifi Proteus

proteus-s3upload-example

An example of a streaming file upload to Amazon S3 using Netifi Proteus.

Prerequisites

This example requires the following prerequisites:

1. AWS Account

2. AWS Access Key ID and AWS Secret Access Key configured on your machine

3. S3 bucket configured in your AWS account that can be accessed by your keys

4. A Running Netifi Proteus Broker

   Run the following command to start a Netifi Proteus Broker:

    docker run \
    -p 8001:8001 \
    -p 7001:7001 \
    -p 9000:9000 \
    -e BROKER_SERVER_OPTS="'-Dnetifi.authentication.0.accessKey=9007199254740991'  \
    '-Dnetifi.broker.console.enabled=true' \
    '-Dnetifi.authentication.0.accessToken=kTBDVtfRBO4tHOnZzSyY5ym2kfY=' \
    '-Dnetifi.broker.admin.accessKey=9007199254740991' \
    '-Dnetifi.broker.admin.accessToken=kTBDVtfRBO4tHOnZzSyY5ym2kfY='" \
    netifi/proteus:1.5.2
   

Building the Example

Follow the steps below to build the example.

1. Run the following Gradle command to build the application:

    ./gradlew clean build
   

Running the Example

Follow the steps below to run the example.

1. Ensure that you have a running Netifi Proteus Broker.

2. Run the following command to start the upload service:

    ./gradlew :service:run
   

3. Run the following command to upload the cat.jpeg image to Amazon S3:

    ./gradlew :client:run --args="{full path to cat.jpeg}"
   

Bugs and Feedback

For bugs, questions, and discussions please use the Github Issues.

Support

Support for Proteus and RSocket is also available on the Netifi Community Forums.

License

Copyright 2018 Netifi Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.