Add best practices for AWS

src/data/best-practices/aws/aws.md

@@ -0,0 +1,28 @@
+---
+jsonUrl: '/jsons/best-practices/aws.json'
+pdfUrl: '/pdfs/best-practices/aws.pdf'
+order: 3
+briefTitle: 'AWS'
+briefDescription: 'AWS Best Practices'
+isNew: true
+isUpcoming: false
+title: 'AWS Best Practices'
+description: 'Detailed list of best practices for Amazon Web Services (AWS)'
+dimensions:
+  width: 968
+  height: 1770.7
+schema:
+  headline: 'AWS Best Practices'
+  description: 'Detailed list of best practices for Amazon Web Services (AWS). Each best practice carries further details and how to implement that best practice.'
+  imageUrl: 'https://roadmap.sh/best-practices/aws.png'
+  datePublished: '2023-02-21'
+  dateModified: '2023-02-21'
+seo:
+  title: 'AWS Best Practices'
+  description: 'Detailed list of best practices for Amazon Web Services (AWS). Each best practice carries further details and how to implement that best practice.'
+  keywords:
+    - 'Amazon Web Services Tips'
+    - 'AWS Tips'
+    - 'AWS Best Practices'
+    - 'Amazon Web Services Best Practices'
+---

src/data/best-practices/aws/content/alerts-as-notifications.md

@@ -0,0 +1,5 @@
+# Alerts as Notifications
+
+> Get your alerts to become notifications.
+
+If you've set everyting up correctly, your health checks should automatically destroy bad instances and spawn new ones. There's usually no action to take when getting a CloudWatch alert, as everything should be automated. If you're getting alerts where manual intervention is required, do a post-mortem and figure out if there's a way you can automate the action in future. The last time I had an actionable alert from CloudWatch was about a year ago, and it's extremely awesome not to be woken up at 4am for ops alerts any more.

src/data/best-practices/aws/content/app-changes-for-aws.md

@@ -0,0 +1,3 @@
+# App Changes for AWS
+
+While a lot of applications can probably just be deployed to an EC2 instance and work well, if you're coming from a physical environment, you may need to re-architect your application in order to accomodate changes. Don't just think you can copy the files over and be done with it.

src/data/best-practices/aws/content/application-state.md

@@ -0,0 +1,9 @@
+# Application State
+
+> Do not store application state on servers.
+
+The reason for this is so that if you server gets killed, you won't lose any application state. To that end, sessions should be stored in a database (or some other sort of central storage; memcached, redis, etc.), not on the local filesystem. Examples:
+
+- Logs should be handled via syslog (or similar) and sent to a remote store.
+- Uploads should go direct to S3 (don't store on local filesystem and have another process move to S3 for example). For S3 you can use [pre-signed URLs](http://docs.aws.amazon.com/AmazonS3/latest/dev/PresignedUrlUploadObject.html) to let your users directly upload to S3 by bypassing your server entirely.
+- Any post-processing or long running tasks should be done via an asynchronous queue (SQS is great for this).

src/data/best-practices/aws/content/automate-everything.md

@@ -0,0 +1,3 @@
+# Automate Everything
+
+This is more of general operations advice than AWS specific, but everything needs to be automated. Recovery, deployment, failover, etc. Package and OS updates should be managed by something, whether it's just a bash script, or Chef/Puppet, etc. You shouldn't have to care about this stuff. As mentioned in a different tip, you should also make sure to disable SSH access, as this will pretty quickly highlight any part of your process that isn't automated. Remember the key phrase from the earlier tip, if you have to SSH into your servers, then your automation has failed.

src/data/best-practices/aws/content/avoid-fs-mounts.md

@@ -0,0 +1,5 @@
+# Avoid FS Mounts
+
+> Avoid filesystem mounts (FUSE, etc).
+
+I've found them to be about as reliable as a large government department when used in critical applications. Use the SDK instead.

src/data/best-practices/aws/content/avoid-multiple-scaling-triggers.md

@@ -0,0 +1,5 @@
+# Multiple Scaling Triggers
+
+> Don't use multiple scaling triggers on the same group.
+
+If you have multiple CloudWatch alarms which trigger scaling actions for the same auto-scaling group, it might not work as you initially expect it to. For example, let's say you add a trigger to scale up when CPU usage gets too high, or when the inbound network traffic gets high, and your scale down actions are the opposite. You might get an increase in CPU usage, but your inbound network is fine. So the high CPU trigger causes a scale-up action, but the low inbound traffic alarm immediately triggers a scale-down action. Depending on how you've set your cooldown period, this can cause quite a problem as they'll just fight against each other. If you want multiple triggers, you can use multiple auto-scaling groups.

src/data/best-practices/aws/content/avoid-server-eips.md

@@ -0,0 +1,5 @@
+# Avoid Server EIPs
+
+> Don't give servers static/elastic IPs.
+
+For a typical web application, you should put things behind a load balancer, and balance them between AZs. There are a few cases where Elastic IPs will probably need to be used, but in order to make best use of auto-scaling you'll want to use a load balancer instad of giving every instance their own unique IP.

src/data/best-practices/aws/content/aws-naming-convention.md

@@ -0,0 +1,5 @@
+# Naming Convention
+
+> Decide on a naming convention early, and stick to it.
+
+There's a lot of resources on AWS where you can change the name later, but there's equally a lot where you cannot (security group names, etc). Having a consistent naming convention will help to self-document your infrastructure. Don't forget to make use of tags too.

src/data/best-practices/aws/content/aws-right-choice.md

@@ -0,0 +1,5 @@
+# AWS Right Choice
+
+> Make sure AWS is right for your workload.
+
+You should make sure that using AWS is correct for your particular workload. If you have a steady load and 24/7 servers, it's possible there are cheaper providers you can use, or it might even be cheaper to use dedicated hardware of your own. One of the big benefits of AWS is the ability to scale up and down rapidly in response to load, but not everyone needs that feature. As when purchasing anything, you should shop around a bit first to make sure you're getting the best deal for what you need

src/data/best-practices/aws/content/beware-aws-limits.md

@@ -0,0 +1,5 @@
+# Beware AWS Limits
+
+> Be aware of AWS service limits before you deploy.
+
+Various service limits are enforced which aren't highlighted until you're actually trying to deploy your application and get the error notification. These limits can easily be increased by making a request to AWS support, however that can involve a significant turn around time (as low as a few minutes, up to a few days, based on past experience), during which you won't be able to finish deploying. A few days before deploying, you should consult the service limits page to see if you think you're going to exceed any of them, and make your support request ahead of time. You will need to make a separate request to each department where you need a limit increased. It's also worth pointing out that some limits are global, while others are per-region.

src/data/best-practices/aws/content/billing-alerts.md

@@ -0,0 +1,5 @@
+# Billing Alerts
+
+> Set up granular billing alerts.
+
+You should always have at least one billing alert set up, but that will only tell you on a monthly basis once you've exceeded your allowance. If you want to catch runaway billing early, you need a more fine grained approach. The way I do it is to set up an alert for my expected usage each week. So the first week's alert for say $1,000, the second for $2,000, third for $3,000, etc. If the week-2 alarm goes off before the 14th/15th of the month, then I know something is probably going wrong. For even more fine-grained control, you can set this up for each individual service, that way you instantly know which service is causing the problem. This could be useful if your usage on one service is quite steady month-to-month, but another is more erratic. Have the indidividual weekly alerts for the steady one, but just an overall one for the more erratic one. If everything is steady, then this is probably overkill, as looking at CloudWatch will quickly tell you which service is the one causing the problem.

src/data/best-practices/aws/content/bucket-names-ssl.md

@@ -0,0 +1,5 @@
+# Bucket Names
+
+> Use "-" instead of "." in bucket names for SSL.
+
+If you ever want to use your bucket over SSL, using a "." will cause you to get certificate mismatch errors. You can't change bucket names once you've created them, so you'd have to copy everything to a new bucket.

src/data/best-practices/aws/content/cloudfront-in-front-of-s3.md

@@ -0,0 +1,7 @@
+# Cloudfront and S3
+
+> You don't have to use CloudFront in front of S3 (but it can help).
+
+If all you care about is scalability, you can link people directly to the S3 URL instead of using CloudFront. S3 can scale to any capacity, so is great if that's all your care about. Additionally, updates are available quickly in S3, yet you have to wait for the TTL when using a CDN to see the change (although I believe you can set a 0s TTL in CloudFront now, so this point is probably moot).
+
+If you need speed, or are handling very high bandwidth (10TB+), then you might want to use a CDN like CloudFront in front of S3. CloudFront can dramatically [speed up access](http://www.quora.com/What-are-typical-latencies-for-static-content-in-S3-vs-Cloudfront) for users around the globe, as it copies your content to edge locations. Depending on your use case, this can also work out slightly cheaper if you deal with very high bandwidth (10TB+) with lower request numbers, as it's about $0.010/GB cheaper for CloudFront bandwidth than S3 bandwidth once you get above 10TB, but the cost per request is slightly higher than if you were to access the files from S3 directly. Depending on your usage pattern, the savings from bandwidth could outweigh the extra cost per request. Since content is only fetched from S3 infrequently (and at a much lower rate than normal), your S3 cost would be much smaller than if you were serving content directly from S3. The [AWS documentation on CloudFront](http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/MigrateS3ToCloudFront.html) explains how you can use it with S3.

src/data/best-practices/aws/content/cloudtrail.md

@@ -0,0 +1,5 @@
+# CloudTrail
+
+> Use CloudTrail to keep an audit log.
+
+CloudTrail will log any action performed via the APIs or web console into an S3 bucket. Set up the bucket with versioning to be sure no one can modify your logs, and you then have a complete audit trail of all changes in your account. You hope that you will never need to use this, but it's well worth having for when you do.

src/data/best-practices/aws/content/cloudwatch-cli-tools.md

@@ -0,0 +1,5 @@
+# CLI Tools
+
+> Use the CLI tools.
+
+It can become extremely tedious to create alarms using the web console, especially if you're setting up a lot of similar alarms, as there's no ability to "clone" an existing alarm while making a minor change elsewhere. Scripting this using the CLI tools can save you lots of time.

src/data/best-practices/aws/content/cloudwatch-custom-metrics.md

@@ -0,0 +1,5 @@
+# Custom Metrics
+
+> Use custom metrics.
+
+If you want to monitor things not covered by the free metrics, you can send your own metric information to CloudWatch and make use of the alarms and graphing features. This can not only be used for things like tracking diskspace usage, but also for custom application metrics too. The AWS page on [publishing custom metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html) has more information.

src/data/best-practices/aws/content/cloudwatch-detailed-monitoring.md

@@ -0,0 +1,5 @@
+# Detailed Monitoring
+
+> Use detailed monitoring.
+
+It's ~$3.50 per instance/month, and well worth the extra cost for the extra detail. 1 minute granularity is much better than 5 minute. You can have cases where a problem is hidden in the 5 minute breakdown, but shows itself quite clearly in the 1 minute graphs. This may not be useful for everyone, but it's made investigating some issues much easier for me.

src/data/best-practices/aws/content/cloudwatch-free-metrics.md

@@ -0,0 +1,5 @@
+# Free Metrics
+
+> Use the free metrics.
+
+CloudWatch monitors all sorts of things for free (bandwidth, CPU usage, etc.), and you get up to 2 weeks of historical data. This saves you having to use your own tools to monitor you systems. If you need longer than 2 weeks, unfortunately you'll need to use a third-party or custom built monitoring solution.

src/data/best-practices/aws/content/configuration-endpoints.md

@@ -0,0 +1,5 @@
+# Configuration Endpoints
+
+> Use the configuration endpoints, instead of individual node endpoints.
+
+Normally you would have to make your application aware of every Memcached node available. If you want to dynamically scale up your capacity, then this becomes an issue as you will need to have some way to make your application aware of the changes. An easier way is to use the configuration endpoint, which means using an AWS version of a Memcached library that abstracts away the auto-discovery of new nodes. The [AWS guide to cache node auto-discovery](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/WhatIs.html) has more information.

src/data/best-practices/aws/content/configured-azs-only.md

@@ -0,0 +1,5 @@
+# Configured AZs
+
+> Only use the availability zones (AZs) your ELB is configured for.
+
+If you add your scaling group to multiple AZs, make sure your ELB is configured to use all of those AZs, otherwise your capacity will scale up, and the load balancer won't be able to see them.

src/data/best-practices/aws/content/disable-ssh-access.md

@@ -0,0 +1,7 @@
+# Disable SSH Access
+
+> Disable SSH access to all servers.
+
+This sounds crazy, I know, but port 22 should be disallowed for everyone in your security group. If there's one thing you take away from this post, this should be it: **If you have to SSH into your servers, then your automation has failed**. Disabling it at the firewall level (rather than on the servers themselves) will help the transition to this frame of thinking, as it will highlight any areas you need to automate, while still letting you easily re-instate access to solve immediate issues. It's incredibly freeing to know that you never need to SSH into an instance. This is both the most frightening and yet most useful thing I've learned.
+
+Disabling inbound SSH has just been a way for me to stop myself cheating with automation (Oh, I'll just SSH in and fix this one thing). I can still re-enable it in the security group if I need to actively debug something on an instance, since sometimes there really is no other way to debug certain issues. It also depends on your application; If your application relies on you being able to push things to a server via SSH, then disabling it might be a bad idea. Blocking inbound SSH worked for me, and forced me to get my automation into a decent state, but it might not be for everyone.

src/data/best-practices/aws/content/ec2-roles.md

@@ -0,0 +1,5 @@
+# EC2 Roles
+
+> Use EC2 roles, do not give applications an IAM account.
+
+If your application has AWS credentials baked into it, you're "doing it wrong". One of the reasons it's important to use the AWS SDK for your language is that you can really easily use EC2 IAM roles. The idea of a role is that you specify the permissions a certain role should get, then assign that role to an EC2 instance. Whenever you use the AWS SDK on that instance, you don't specify any credentials. Instead, the SDK will retrieve temporary credentials which have the permissions of the role you set up. This is all handled transparently as far as you're concerned. It's secure, and extremely useful.

src/data/best-practices/aws/content/elb-healthchecks.md

@@ -0,0 +1,5 @@
+# ELB Healthchecks
+
+> Use ELB health check instead of EC2 health checks.
+
+This is a configuration option when creating your scaling group, you can specify whether to use the standard EC2 checks (is the instance connected to the network), or to use your ELB health check. The ELB health check offers way more flexibility. If your health check fails and the instance gets taken out of the load balancing pool, you're pretty much always going to want to have that instance killed by auto-scaling and a fresh one take it's place. If you don't set up your scaling group to use the ELB checks, then that won't necessarily happen. The [AWS documentation on adding the health check](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-add-elb-healthcheck.html) has all the information you need to set this up.

src/data/best-practices/aws/content/failover-event-subscription.md

@@ -0,0 +1,5 @@
+# Failover Event Subscription
+
+> Set up event subscriptions for failover.
+
+If you're using a Multi-AZ setup, this is one of those things you might not think about which ends up being incredibly useful when you do need it.

src/data/best-practices/aws/content/group-permissions.md

@@ -0,0 +1,5 @@
+# Group Permissions
+
+> Assign permissions to groups, not users.
+
+Managing users can be a pain, if you're using Active Directory, or some other external authentication mechanism which you've integrated with IAM, then this probably won't matter as much (or maybe it matters more). But I've found it much easier to manage permissions by assigning them only to groups, rather than to individual users. It's much easier to rein in permissions and get an overall view of the system than going through each individual user to see what permissions have been assigned.

src/data/best-practices/aws/content/index.md

@@ -0,0 +1 @@
+# 

src/data/best-practices/aws/content/key-management-strategy.md

@@ -0,0 +1,5 @@
+# Key Management Strategy
+
+> Decide on a key-management strategy from the start.
+
+Are you going to have one key-pair per group of instances, or are you going to have one key-pair you use for your entire account? It's easy to modify your authorized-keys file with a bootstrap script of course, but you need to decide if you want to manage multiple key-pairs or not, as things will get complicated later on if you try to change your mind.

src/data/best-practices/aws/content/lock-security-groups.md

@@ -0,0 +1,5 @@
+# Lock Security Groups
+
+> Lock down your security groups.
+
+Don't use `0.0.0.0/0` if you can help it, make sure to use specific rules to restrict access to your instances. For example, if your instances are behind an ELB, you should set your security groups to only allow traffic from the ELBs, rather than from `0.0.0.0/0`. You can do that by entering "amazon-elb/amazon-elb-sg" as the CIDR (it should auto-complete for you). If you need to allow some of your other instances access to certain ports, don't use their IP, but specify their security group identifier instead (just start typing "sg-" and it should auto-complete for you).

src/data/best-practices/aws/content/logs-information.md

@@ -0,0 +1,5 @@
+# Logs Information
+
+> Store extra information in your logs.
+
+Log lines normally have information like timestamp, pid, etc. You'll also probably want to add instance-id, region, availability-zone and environment (staging, production, etc), as these will help debugging considerably. You can get this information from the [instance metadata service](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AESDG-chapter-instancedata.html). The method I use is to grab this information as part of my bootstrap scripts, and store it in files on the filesystem (/env/az, /env/region, etc). This way I'm not constantly querying the metadata service for the information. You should make sure this information gets updated properly when your instances reboot, as you don't want to save an AMI and have the same data persist, as it will then be incorrect.

src/data/best-practices/aws/content/multi-factor-auth-iam.md

@@ -0,0 +1,5 @@
+# Multi-factor Auth
+
+> IAM users can have multi-factor authentication, use it!
+
+Enable MFA for your IAM users to add an extra layer of security. Your master account should most definitely have this, but it's also worth enabling it for normal IAM users too.

src/data/best-practices/aws/content/pre-warm-elb.md

@@ -0,0 +1,6 @@
+# Pre-Warm ELB
+
+> Pre-warm your ELBs if you're expecting heavy traffic.
+
+
+It takes time for your ELB to scale up capacity. If you know you're going to have a large traffic spike (selling tickets, big event, etc), you need to "warm up" your ELB in advance. You can inject a load of traffic, and it will cause ELB to scale up and not choke when you actually get the traffic, however AWS suggest you contact them instead to prewarm your load balancer. (Source: [Best Practices in Evaluating Elastic Load Balancing](https://aws.amazon.com/articles/best-practices-in-evaluating-elastic-load-balancing/#pre-warming)). Alternatively you can install your own load balancer software on an EC2 instance and use that instead (HAProxy, etc).

src/data/best-practices/aws/content/random-strings-keys.md

@@ -0,0 +1,5 @@
+# S3 Keys
+
+> Use random strings at the start of your keys.
+
+This seems like a strange idea, but one of the implementation details of S3 is that Amazon use the object key to determine where a file is physically placed in S3. So files with the same prefix might end up on the same hard disk for example. By randomising your key prefixes, you end up with a better distribution of your object files. (Source: [S3 Performance Tips & Tricks](https://aws.amazon.com/blogs/aws/amazon-s3-performance-tips-tricks-seattle-hiring-event/))

src/data/best-practices/aws/content/redundant-across-azs.md

@@ -0,0 +1,5 @@
+# Redundant Across AZs
+
+> Always be redundant across availability zones (AZs).
+
+AZs can have outages, it's happened in the past that certain things in an AZ have gone down. Spreading your application into multiple AZs is as simple as adding a new AZ to your load balancer and starting an instance in that AZ. You should spread your load over two AZs at the very least! If you can afford it, being redundant across regions can also be well worth it, but this generally has a more complex set up cost and isn't always necessary. You can now copy AMIs between regions, and you can set up your Route53 records to balance traffic between regions, but you can't use a single ELB across regions.

src/data/best-practices/aws/content/release-eips.md

@@ -0,0 +1,5 @@
+# Release EIPs
+
+> Don't keep unassociated Elastic IPs.
+
+You get charged for any Elastic IPs you have created but not associated with an instance, so make sure you don't keep them around once you're done with them.

src/data/best-practices/aws/content/reserved-instances.md

@@ -0,0 +1,5 @@
+# Reserved Instances
+
+> Use reserved instances to save big $$$.
+
+Reserving an instance is just putting some money upfront in order to get a lower hourly rate. It ends up being a lot cheaper than an on-demand instance would cost. So if you know you're going to be keeping an instance around for 1 or 3 years, it's well worth reserving them. Reserved instances are a purely logical concept in AWS, you don't assign a specific instance to be reserved, but rather just specify the type and size, and any instances that match the criteria will get the lower price.

src/data/best-practices/aws/content/s3-hive-results.md

@@ -0,0 +1,5 @@
+# Hive Results
+
+> Specify a directory on S3 for Hive results.
+
+If you use Hive to output results to S3, you must specify a directory in the bucket, not the root of the bucket, otherwise you'll get a rather unhelpful NullPointerException with no real explanation as to why.

src/data/best-practices/aws/content/scale-down-events.md

@@ -0,0 +1,5 @@
+# Scale Down
+
+> Scale down on INSUFFICIENT_DATA as well as ALARM.
+
+For your scale-down action, make sure to trigger a scale-down event when there's no metric data, as well as when your trigger goes off. For example, if you have an app which usually has very low traffic, but experiences occasional spikes, you want to be sure that it scales down once the spike is over and the traffic stops. If there's no traffic, you'll get `INSUFFIFIENT_DATA` instead of `ALARM` for your low traffic threshold and it won't trigger a scale-down action.

src/data/best-practices/aws/content/scale-horizontally.md

@@ -0,0 +1,3 @@
+# Scale Horizontally
+
+I've found that using lots of smaller machines is generally more reliable than using a smaller number of larger machines. You need to balance this though, as trying to run your application from 100 t1.micro instances probably isn't going to work very well. Breaking your application into lots of smaller instances means you'll be more resiliant to failure in one of the machines. If you're just running from two massive compute cluster machines, and one goes down, things are going to get bad.

src/data/best-practices/aws/content/security-audit.md

@@ -0,0 +1,7 @@
+# Security Audit
+
+> Set up automated security auditing.
+
+It's important to keep track of changes in your infrastructure's security settings. One way to do this is to first set up a security auditer role ([JSON template](https://gist.github.com/bigsnarfdude/d0758b4fd335085623be)), which will give anyone assigned that role read-only access to any security related settings on your account. You can then use this rather [fantastic Python script](https://gist.github.com/jlevy/cce1b44fc24f94599d0a4b3e613cc15d), which will go over all the items in your account and produce a canonical output showing your configuration. You set up a cronjob somewhere to run this script, and compare its output to the output from the previous run. Any differences will show you exactly what has been changed in your security configuration. It's useful to set this up and just have it email you the diff of any changes. (Source: Intrusion Detection in the Cloud - [Presentation](http://awsmedia.s3.amazonaws.com/SEC402.pdf))
+
+

src/data/best-practices/aws/content/service-over-servers.md

@@ -0,0 +1,5 @@
+# Service Over Servers
+
+> Servers are ephemeral, you don't care about them. You only care about the service as a whole.
+
+If a single server dies, it should be of no big concern to you. This is where the real benefit of AWS comes in compared to using physical servers yourself. Normally if a physical server dies, there's panic. With AWS, you don't care, because auto-scaling will give you a fresh new instance soon anyway. Netflix have taken this several steps further with their [simian army](http://techblog.netflix.com/2011/07/netflix-simian-army.html), where they have things like [Chaos Monkey](http://techblog.netflix.com/2012/07/chaos-monkey-released-into-wild.html), which will kill random instances in production (they also have Chaos Gorilla to kill AZs and I've heard rumour of a Chaos Kong to kill regions...). The point is that servers will fail, but this shouldn't matter in your application.

src/data/best-practices/aws/content/tag-everything.md

@@ -0,0 +1,3 @@
+# Tag Everything
+
+Pretty much everything can be given tags, use them! They're great for organising things, make it easier to search and group things up. You can also use them to trigger certain behaviour on your instances, for example a tag of env=debug could put your application into debug mode when it deploys, etc.

src/data/best-practices/aws/content/terminate-ssl.md

@@ -0,0 +1,5 @@
+# Terminate SSL
+
+> Terminate SSL on the load balancer.
+
+You'll need to add your SSL certificate information to the ELB, but this will take the overhead of SSL termination away from your servers which can speed things up. Additionally, if you upload your SSL certificate, you can pass through the HTTPS traffic and the load balancer will add some extra headers to your request (x-forwarded-for, etc), which are useful if you want to know who the end user is. If you just forward TCP, then those headers aren't added and you lose the information.

src/data/best-practices/aws/content/termination-protection.md

@@ -0,0 +1,5 @@
+# Termination Protection
+
+> Use termination protection for non-auto-scaling instances.
+
+If you have any instances which are one-off things that aren't under auto-scaling, then you should probably enable termination protection, to stop anyone from accidentally deleting the instance. I've had it happen, it sucks, learn from my mistake!

src/data/best-practices/aws/content/tools-for-logs.md

@@ -0,0 +1,5 @@
+# Tools for Logs
+
+> Have tools to view application logs.
+
+You should have an admin tool, syslog viewer, or something that allows you to view current real-time log info without needing to SSH into a running instance. If you have centralised logging (which you really should), then you just want to be sure you can read the logs there without needing to use SSH. Needing to SSH into a running application instance to view logs is going to become problematic.

src/data/best-practices/aws/content/use-alias-records.md

@@ -0,0 +1,5 @@
+# ALIAS Records
+
+> Use ALIAS records.
+
+An ALIAS record will link your record set to a particular AWS resource directly (i.e. you can map a domain to an S3 bucket), but the key is that you don't get charged for any ALIAS lookups. So whereas a CNAME entry would cost you money, an ALIAS record won't. Also, unlike a CNAME, you can use an ALIAS on your zone apex. You can read more about this on [the AWS page for creating alias resource record sets](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingAliasRRSets.html).

src/data/best-practices/aws/content/use-iam-acount.md

@@ -0,0 +1,8 @@
+# Use IAM Acounts
+
+> Everyone gets an IAM account. Never login to the master.
+
+Usually you'll have an "operations account" for a service, and your entire ops team will have the password. With AWS, you definitely don't want to do that. Everyone gets an IAM user with just the permissions they need (least privilege). An IAM user can control everything in the infrastructure. At the time of writing, the only thing an IAM user can't access are some parts of the billing pages.
+
+If you want to protect your account even more, make sure to [enable multi-factor authentication](http://aws.amazon.com/iam/details/mfa/) for everyone (you can use Google Authenticator). I've heard of some users who give the MFA token to two people, and the password to two others, so to perform any action on the master account, two of the users need to agree. This is overkill for my case, but worth mentioning in case someone else wants to do it.
+

src/data/best-practices/aws/content/use-iam-roles.md

@@ -0,0 +1,3 @@
+# Use IAM Roles
+
+Don't create users for application, always use IAM roles if you can. They simplify everything, and keeps things secure. Having application users just creates a point of failure (what if someone accidentally deletes the API key?) and it becomes a pain to manage.

src/data/best-practices/aws/content/use-official-sdks.md

@@ -0,0 +1,5 @@
+# Use Official SDKs
+
+> If you need to interact with AWS, use the SDK for your langauge.
+
+Don't try to roll your own, I did this at first as I only needed a simple upload to S3, but then you add more services and it's just an all around bad idea. [The AWS SDKs](http://aws.amazon.com/tools/) are well written, handle authentication automatically, handle retry logic, and they're maintained and iterated on by Amazon. Also, if you use EC2 IAM roles (which you absolutely should, more on this later) then the SDK will automatically grab the correct credentials for you.

src/data/best-practices/aws/content/use-vpc.md

@@ -0,0 +1,5 @@
+# Use VPC
+
+Setting up a VPC seems like a pain at first, but once you get stuck in and play with it, it's suprising easy to set up and get going. It provides all sorts of extra features over EC2 that are well worth the extra time it takes to set up a VPC. First, you can control traffic at the network level using ACLs, you can modify instance size, security groups, etc. without needing to terminate an instance. You can specify egress firewall rules (you cannot control outbound traffic from normal EC2). But the biggest thing is that you have your own private subnet where your instances are completely cut off from everyone else, so it adds an extra layer of protection.
+
+If you're interested in the internals of VPC, I highly recommend watching [A Day in the Life of Billion Packets](http://www.youtube.com/watch?v=Zd5hsL-JNY4) ([Slides](https://www.slideshare.net/AmazonWebServices/a-day-in-the-life-of-a-billion-packets-cpn401-aws-reinvent-2013)).

src/data/best-practices/aws/content/user-multiple-api-keys.md

@@ -0,0 +1,5 @@
+# Multiple API Keys
+
+> Users can have multiple API keys.
+
+This can be useful if someone is working on multiple projects, or if you want a one-time key just to test something out, without wanting to worry about accidentally revealing your normal key.

src/pages/pdfs.md

@@ -37,4 +37,5 @@ Here is the list of PDF links for each of the roadmaps.
 Here is the list of PDF links for each of the best practices:
 
 * **Frontend Performance** - [Best Practices Link](https://roadmap.sh/best-practices/frontend-performance) / [PDF Link](https://roadmap.sh/pdfs/best-practices/frontend-performance.pdf)
-* **API Security** - [Best Practices Link](https://roadmap.sh/best-practices/api-security) / [PDF Link](https://roadmap.sh/pdfs/best-practices/api-security.pdf)
+* **API Security** - [Best Practices Link](https://roadmap.sh/best-practices/api-security) / [PDF Link](https://roadmap.sh/pdfs/best-practices/api-security.pdf)
+* **Amazon Web Services (AWS)** - [Best Practices Link](https://roadmap.sh/best-practices/aws) / [PDF Link](https://roadmap.sh/pdfs/best-practices/aws.pdf)