This repository contains step by step guide to provision AWS S3 bucket, AWS SNS Queue and have Integration between both of them. The infrastructure is created using terraform code and expected to have some working knowledge on the terraform

1. Installation of AWSCLI
2. Install GIT (required to download this repo)
3. Install Terraform (Install and basic knowledge on troubleshooting)
4. Install Ruby and its dependencies

brew install ruby
brew install rbenv

# Also add this to your ~/.bash_profile
export PATH="$HOME/.rbenv/shims:$PATH"

rbenv install 2.6.0
rbenv global 2.6.0

Once specific version is installed, then install bundler. bundler provides a consistent environment for ruby projects by tracking and installing the exact gems that are needed.

sudo gem install bundler

Install all the ruby gems required for this project.

bundle install

It will create a Gemfile.lock At this point, you have installed all the Components to run terraform code, and Ruby dependencies that are required to test your terraform module.

• Download the latest source from this repo

If you already have the repo downloaded and unsure about having latest, git pull command will bring the latest code

    commands:
    git clone [email protected]:ramgad/tf_aws_s3_sqs_kitchen_test.git

The AWS CLI stores sensitive credential information that you specify with aws configure in a local file named credentials, in a folder named .aws in your home directory.

For example, the files generated by the AWS CLI for a default profile configured with aws configure looks similar to the following.

~/.aws/credentials

[default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

[mypersonalAWSaccount-dev] aws_access_key_id=ALIATHISODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7EXXY/bPxRfiCYEXAMPLEKEY

Export AWS profile by pointing to the desired account.

export AWS_PROFILE= -- Please ensure that this entry exists in the ~/.aws/credentials file

Test connectivity: aws s3 ls

In case you want setup new AWS profile, more information can be found here.

The assumption is that your AWS profile with the above keys have required IAM roles (privileges) to create the SNS and S3 bucket

Edit the file - vi or nano terraform.tfvars and populate values to the parameters

terraform.tfvars
```
aws_region     = "<<Enter AWS Region>>"     //Enter AWS regions where you want to run this code against
sns_topic_name = "<<Enter-Unique-SNS-Topic-Name>>"   //Custom SNS Topic Name
bucket_name    = "<<Enter-AWS-Global-Unique-S3-Bucket-Name>>" //An Amazon S3 bucket name is globally unique, and the namespace is shared by all AWS accounts
tags           = [] // Array of key pairs
emails         = ["<<Enter Email Address, ensure to Confirm the Subscription"] //Array of Email Ids
```

Please follow the steps below to run the code

1. terraform init
2. terraform validate
3. terraform plan -var-file="terraform.tfvars" -out "plan.out"
4. terraform apply "plan.out"

You will receive subscription confirmation email (assuming the terraform.tfvars has your email address). Upon confirming the subscription, you can go ahead and upload a new file in the s3 bucket. You should see a notification sent out to the email

1. Initializes the Test: 
    
    "bundle exec kitchen create"
    
2. Creates the resources for testing: 
    
    "bundle exec kitchen converge"

3. Actual Test runs with this command: 
    
    "bundle exec kitchen verify"
    
4. Cleanup: 
    
    "bundle exec kitchen destroy"
    

Issue the following commands from where the terraform apply was run. The same location hosts the terraform state and will help in cleaning all the resources it has created

1. terraform destroy -auto-approve