Skip to content

Latest commit

 

History

History
26 lines (23 loc) · 1.89 KB

Setup_AWS_CLI_and_S3_Bucket.md

File metadata and controls

26 lines (23 loc) · 1.89 KB

Setup CLI and Create S3 Bucket

The developer is required to create a S3 bucket for the AFI generation. The bucket will contain a tar file and logs which are generated from the AFI creation service.

To install the AWS CLI, please follow the instructions here: (http://docs.aws.amazon.com/cli/latest/userguide/installing.html).

The AWS SDAccel scripts require JSON output format and the scripts will not work properly if you use any other output format types (ex: text, table). JSON is the default output format of the AWS CLI.

    $ aws configure         # to set your credentials (found in your console.aws.amazon.com page), region (us-east-1) and output (json) 

This S3 bucket will be used by the AWS SDAccel scripts to upload your DCP to AWS for AFI generation which will be packaged into a tar file.
Start by creating a bucket and a folder within your new bucket:

    $ aws s3 mb s3://<bucket-name> --region us-east-1  # Create an S3 bucket (choose a unique bucket name)
    $ aws s3 mb s3://<bucket-name>/<dcp-folder-name>   # Create folder for your tarball files
    $ touch FILES_GO_HERE.txt                          # Create a temp file
    $ aws s3 cp FILES_GO_HERE.txt s3://<bucket-name>/<dcp-folder-name>/  # Which creates the folder on S3

The AFI creation process will generate logs and will be placed in your S3 bucket. These logs can be used for debug if the AFI generation fails.
Next, create a folder for your log files:

    $ aws s3 mb s3://<bucket-name>/<logs-folder-name>  # Create a folder to keep your logs
    $ touch LOGS_FILES_GO_HERE.txt                     # Create a temp file
    $ aws s3 cp LOGS_FILES_GO_HERE.txt s3://<bucket-name>/<logs-folder-name>/  # Which creates the folder on S3

Once your AFI has been created successfully, you are free to delete the tar file and logs as needed. Deleting these files will not delete or modify your AFI.