Application for copying Amazon Kinesis data to S3.

### Usage

1. [Download the app](TODO)
2. Configure your application (start with the template `KinesisToS3.SAMPLE.properties`)
3. Configure AWS access credentials:
    1. Locally, set either
        1. the environment variables `AWS_ACCESS_KEY_ID=xxx` and `AWS_SECRET_KEY=yyy`
        2. or the JVM options `-Daws.accessKeyId=xxx` and `-D=aws.secretKey=yyy`
    2. On Amazon EC2
        1. No configuration needed if you start the server instance with a proper IAM role (highly recommended!)
4. Run the app: `java -jar kinesis-to-s3-[version].jar configuration.properties`

### Building the app

The build uses Maven. Run

    mvn package
to create a runnable jar under `./target/`

### Development

See the main class `com.github.codeflows.aws.KinesisToS3`

### Rationale

The Kinesis sample code is complex, this project does one thing in a couple of lines of code.

### Notes

The project contains `amazon-kinesis-connectors` as a Git submodule [because it's not offered as a Maven dependency yet.](https://github.com/awslabs/amazon-kinesis-connectors/pull/11)

# kinesis-to-s3

Application for copying Amazon Kinesis data to S3.

Uses the [Amazon Kinesis Client Library](https://github.com/awslabs/amazon-kinesis-client)
and the [Amazon Kinesis Connector Library](https://github.com/awslabs/amazon-kinesis-connectors).

## Usage

1. [Download the app](TODO)
2. Configure your application (start with the template `KinesisToS3.SAMPLE.properties`)
3. Configure AWS access credentials:
    1. Locally, set either
        1. the environment variables `AWS_ACCESS_KEY_ID=xxx` and `AWS_SECRET_KEY=yyy`
        2. or the JVM options `-Daws.accessKeyId=xxx` and `-D=aws.secretKey=yyy`
    2. On Amazon EC2
        1. No configuration needed if you start the server instance with a proper IAM role (highly recommended!)
4. Run the app: `java -jar kinesis-to-s3-[version].jar configuration.properties`

## Building the app

The build uses Maven. Run

    mvn package
to create a runnable jar under `./target/`

## Development

See the main class `com.github.codeflows.aws.KinesisToS3`

## Rationale

The [Kinesis Connector sample code](https://github.com/awslabs/amazon-kinesis-connectors/tree/master/src/main/samples)
is pretty complex, this project does one simple thing.

## Notes

The project contains `amazon-kinesis-connectors` as a Git submodule [because it's not offered as a Maven dependency yet.](https://github.com/awslabs/amazon-kinesis-connectors/pull/11)

Add links to AWS projects
Add links to AWS projects
