Skip to content

Commit

Permalink
feat(docs): Add info about Tag policies (#248)
Browse files Browse the repository at this point in the history
* feat(docs): Add info about Tag policies

* chore(docs): clean up todos

* add internal disclaimer at top
  • Loading branch information
lewisdaly authored Aug 24, 2020
1 parent 0decaa5 commit b2a2c96
Show file tree
Hide file tree
Showing 5 changed files with 54 additions and 5 deletions.
59 changes: 54 additions & 5 deletions discussions/aws_tagging.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,20 @@
# AWS Tagging Guidelines
# AWS Tagging Guidelines + Policies

> **Note:** These guidelines are specific to the Mojaloop Community's AWS Environment for testing and validating Mojaloop installations, and are primarily for internal purposes. They may, however, be a useful reference to others wishing to implement similar tagging strategies in their own organizations.
To better manage and understand our AWS usage and spending, we are implementing the following tagging guidelines.

## Contents
- [Proposed tags and their meanings](#proposed-tags-and-their-meanings)
- [mojaloop/cost_center](#mojaloopcost_center)
- [mojaloop/owner](#mojaloopowner)
- [Manual Tagging](#manual-tagging)
- [Automated Tagging](#automated-tagging)
- [AWS Tagging Policies](#aws-tagging-policies)
- [Viewing Tag Reports + Compliance](#viewing-tag-reports--compliance)
- [Editing Tag Policies](#editing-tag-policies)
- [Attaching/Detaching Tag Policies](#attachingdetaching-tag-policies)

## Proposed tags and their meanings

We propose the following 2 tag _keys_:
Expand Down Expand Up @@ -48,8 +61,6 @@ Once again, we will reserve the following values:

We can use the "Tag Editor" in the AWS console to search for untagged resources.

>TODO: insert instructions
1. Log into the AWS Console
2. Under Resource Groups, select "Tag Editor"
![](./images/tagging_01.png)
Expand All @@ -65,14 +76,52 @@ You can also search by tags, or the absense of tags to see what resources have n

## Automated Tagging

We currently automate tagging on the following

As we have a firmer grasp of our tagging guidelines, we need to introduce them into our tooling so that all of the grunt work of manual tagging.

At the moment, this will look like introducing tags into:
1. Rancher - which currently manages our Kubernetes clusters for both QA and Performance purposes
2. IAC - The upcoming IAC code that will eventually be running our dev environments


## Searching for Untagged Resources
## AWS Tagging Policies

As of August 3, 2020, we have started introducing [AWS Tagging Policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html) to better enforce tags and monitor our resources (especially with respect to costs).


### Viewing Tag Reports + Compliance

1. Log in to the AWS Console
2. "Resource Groups" > "Tag Editor"
3. On the left sidebar, select "Tag Policies"

From here you can see the tag policies "compliance report"

![](./images/tagging_03.png)


### Editing Tag Policies

> Note: This may require special admin priviledges to access these pages
1. Log in to the AWS Console
2. Select "username@mojaloop" in the top right > "My Organization"
3. Select "Policies" > "Tag Policies"

![](./images/tagging_04.png)

4. From here, you can view the current tag policies

![](./images/tagging_05.png)

5. In the sidebar, you can click "View details" > "Edit policy" to edit the policy


### Attaching/Detaching Tag Policies

> TODO: Lewis will investigate an writing a script for automating the search for untagged resources, that perhaps can send a weekly email or slack notification to AWS owners to investigate and retag instances.
1. Go to the "My Organization" page
2. Select the relevant account > "Tag policies" in the sidebar
3. From here you can Attach + Detach tag policies

![](./images/tagging_06.png)
Binary file added discussions/images/tagging_03.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added discussions/images/tagging_04.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added discussions/images/tagging_05.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added discussions/images/tagging_06.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit b2a2c96

Please sign in to comment.