Skip to content

Latest commit

 

History

History
executable file
·
81 lines (55 loc) · 3.49 KB

README.md

File metadata and controls

executable file
·
81 lines (55 loc) · 3.49 KB
Raw

S3Proxy on Cloud Foundry Demo

Sample app to show S3Proxy enabling developers to use the same code base to get content from AWS S3 and Azure Storage

S3Proxy allows applications using the S3 API to access other storage backends, e.g., local file system, Google Cloud Storage, Microsoft Azure, OpenStack Swift. This application demonstrates how a user can setup S3Proxy in Cloud Foundry to use the same code base to get content from both AWS S3 and Azure Storage.

Prerequisites

To run this application you need to first obtain the following:
  • Azure Storage Account name
  • Azure Storage Account access key
  • AWS S3 Account key
  • AWS S3 Account secret
Create a container in your storage account, you will need this later.
Upload invoice_aws.json to S3 and invoice_azure.json to Azure storage

Deploying S3Proxy as an App to Cloud Foundry

Deploy 2 instances of s3proxy to CF, follow these steps
  • S3Proxy for Azure:
    • App url: s3proxy.app.<cf instance public ip>.xip.io
    • Create a wildcard route for this instance as: *.app.<cf instance public ip>.xip.io
    • Note to use s3proxy.app.<cf instance public ip>.xip.io for s3proxy.virtual-host in the s3proxy.conf file before you push it to docker hub
  • S3Proxy for AWS:
    • App url: s3proxyaws.app..xip.io
    • Create a domain s3proxyapp.<cf instance public ip>.xip.io
    • Create a wildcard route for this instance as: *.s3proxyapp.<cf instance public ip>.xip.io
    • Note to use s3proxy.s3proxyapp.<cf instance public ip>.xip.io for s3proxy.virtual-host in the s3proxy.conf file before you push it to docker hub
    • Make sure you provide AWS values for jclouds.region, jclouds.provider=aws-s3,jclouds.identity,jclouds.credential

Providing Configurations

Create a file application.properties at the project root with the following properties and values:
azure.storage.account.name=
azure.storage.account.key=
s3proxy.azureendpoint= <this is the endpoint for the s3proxy for azure, make sure to use the new domain created in previous section, for example: "s3proxy.app.[cf url]">
s3proxy.awsendpoint= <this is the endpoint for the s3proxy for aws, make sure to use the new domain created in previous section, for example: "s3proxyaws.s3proxyapp.[cf url]" >
containername= <this is the container already created in your storage account for both azure and aws>
AWS_ACCESS_KEY=
AWS_SECRET_ACCESS_KEY=

Create a file manifest.yml from manifest.template.yml. Fill in the same properties/values as application.properties.

Building the App

To build this application:

mvn clean package

Deploying the App to Cloud Foundry

To push this application to CF:

cf push <appname>

Testing the App

To test this deployment:

Hit the following URL:

http://<appname>.app.<cf instance public ip>.xip.io/aws
http://<appname>.app.<cf instance public ip>.xip.io/azure
http://<appname>.app.<cf instance public ip>.xip.io/s3proxyaws
http://<appname>.app.<cf instance public ip>.xip.io/s3proxyazure

Acknowledgement

This application was derived from azure-doge.

Additional Resources