-
Notifications
You must be signed in to change notification settings - Fork 33
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8b71ed8
commit 8bb3635
Showing
6 changed files
with
232 additions
and
44 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,3 +6,6 @@ | |
.terraform/ | ||
.idea | ||
terraform-aws-dynamodb-autoscaler.iml | ||
|
||
.build-harness | ||
build-harness |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,10 @@ | ||
SHELL := /bin/bash | ||
|
||
# List of targets the `readme` target should call before generating the readme | ||
export README_DEPS ?= docs/targets.md docs/terraform.md | ||
|
||
-include $(shell curl -sSL -o .build-harness "https://git.io/build-harness"; echo .build-harness) | ||
|
||
## Lint terraform code | ||
lint: | ||
$(SELF) terraform/install terraform/get-modules terraform/get-plugins terraform/lint terraform/validate | ||
$(SELF) terraform/install terraform/get-modules terraform/get-plugins terraform/lint terraform/validate |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,26 @@ | ||
# terraform-aws-dynamodb-autoscaler [](https://travis-ci.org/cloudposse/terraform-aws-dynamodb-autoscaler) | ||
<!-- This file was automatically generated by the `build-harness`. Make all changes to `README.yaml` and run `make readme` to rebuild this file. --> | ||
|
||
[](https://cloudposse.com) | ||
|
||
# terraform-aws-dynamodb-autoscaler [](https://travis-ci.org/cloudposse/terraform-aws-dynamodb-autoscaler) [](https://github.com/cloudposse/terraform-aws-dynamodb-autoscaler/releases/latest) [](https://slack.cloudposse.com) | ||
|
||
|
||
Terraform module to provision DynamoDB autoscaler. | ||
|
||
Autoscaler scales up/down the provisioned OPS for a DynamoDB table based on the load. | ||
|
||
|
||
--- | ||
|
||
This project is part of our comprehensive ["SweetOps"](https://docs.cloudposse.com) approach towards DevOps. | ||
|
||
|
||
It's 100% Open Source and licensed under the [APACHE2](LICENSE). | ||
|
||
|
||
|
||
|
||
|
||
## Usage | ||
|
||
```hcl | ||
|
@@ -26,35 +42,79 @@ module "dynamodb_autoscaler" { | |
``` | ||
|
||
|
||
## Variables | ||
|
||
| Name | Default | Description | Required | | ||
|:---------------------------------|:-------------|:--------------------------------------------------------------------------------|:--------:| | ||
| `namespace` | `` | Namespace (_e.g._ `cp` or `cloudposse`) | Yes | | ||
| `stage` | `` | Stage (_e.g._ `prod`, `dev`, `staging`) | Yes | | ||
| `name` | `` | Name (_e.g._ `app` or `cluster`) | Yes | | ||
| `dynamodb_table_name` | `` | DynamoDB table name | Yes | | ||
| `dynamodb_indexes` | `[]` | List of DynamoDB indexes | No | | ||
| `dynamodb_table_arn` | `` | DynamoDB table ARN | Yes | | ||
| `attributes` | `[]` | Additional attributes (_e.g._ `1`) | No | | ||
| `tags` | `{}` | Additional tags (_e.g._ `map("BusinessUnit","XYZ")` | No | | ||
| `delimiter` | `-` | Delimiter to be used between `namespace`, `stage`, `name` and `attributes` | No | | ||
| `autoscale_write_target` | `50` | The target value for DynamoDB write autoscaling | No | | ||
| `autoscale_read_target` | `50` | The target value for DynamoDB read autoscaling | No | | ||
| `autoscale_min_read_capacity` | `5` | DynamoDB autoscaling min read capacity | No | | ||
| `autoscale_max_read_capacity` | `20` | DynamoDB autoscaling max read capacity | No | | ||
| `autoscale_min_write_capacity` | `5` | DynamoDB autoscaling min write capacity | No | | ||
| `autoscale_max_write_capacity` | `20` | DynamoDB autoscaling max write capacity | No | | ||
| `enabled` | `true` | Set to false to prevent the module from creating any resources | No | | ||
|
||
|
||
|
||
## Makefile Targets | ||
``` | ||
Available targets: | ||
help This help screen | ||
help/all Display help for all targets | ||
lint Lint terraform code | ||
``` | ||
|
||
## Inputs | ||
|
||
| Name | Description | Type | Default | Required | | ||
|------|-------------|:----:|:-----:|:-----:| | ||
| attributes | Additional attributes (e.g. `1`) | list | `<list>` | no | | ||
| autoscale_max_read_capacity | DynamoDB autoscaling max read capacity | string | `20` | no | | ||
| autoscale_max_write_capacity | DynamoDB autoscaling max write capacity | string | `20` | no | | ||
| autoscale_min_read_capacity | DynamoDB autoscaling min read capacity | string | `5` | no | | ||
| autoscale_min_write_capacity | DynamoDB autoscaling min write capacity | string | `5` | no | | ||
| autoscale_read_target | The target value for DynamoDB read autoscaling | string | `50` | no | | ||
| autoscale_write_target | The target value for DynamoDB write autoscaling | string | `50` | no | | ||
| delimiter | Delimiter to be used between `namespace`, `stage`, `name` and `attributes` | string | `-` | no | | ||
| dynamodb_indexes | List of DynamoDB indexes | list | `<list>` | no | | ||
| dynamodb_table_arn | DynamoDB table ARN | string | - | yes | | ||
| dynamodb_table_name | DynamoDB table name | string | - | yes | | ||
| enabled | Set to false to prevent the module from creating any resources | string | `true` | no | | ||
| name | Name (e.g. `app` or `cluster`) | string | - | yes | | ||
| namespace | Namespace (e.g. `cp` or `cloudposse`) | string | - | yes | | ||
| stage | Stage (e.g. `prod`, `dev`, `staging`, `infra`) | string | - | yes | | ||
| tags | Additional tags (e.g. map(`BusinessUnit`,`XYZ`) | map | `<map>` | no | | ||
|
||
|
||
|
||
|
||
## Related Projects | ||
|
||
Check out these related projects. | ||
|
||
- [terraform-aws-dynamodb](https://github.com/cloudposse/terraform-aws-dynamodb) - Terraform module that implements AWS DynamoDB with support for AutoScaling | ||
- [terraform-aws-tfstate-backend](https://github.com/cloudposse/terraform-aws-tfstate-backend) - Provision an S3 bucket to store terraform.tfstate file and a DynamoDB table to lock the state file to prevent concurrent modifications and state corruption | ||
|
||
|
||
|
||
## Help | ||
|
||
**Got a question?** | ||
|
||
File a GitHub [issue](https://github.com/cloudposse/terraform-aws-dynamodb-autoscaler/issues), send us an [email](mailto:[email protected]) or reach out to us on [Gitter](https://gitter.im/cloudposse/). | ||
File a GitHub [issue](https://github.com/cloudposse/terraform-aws-dynamodb-autoscaler/issues), send us an [email][email] or join our [Slack Community][slack]. | ||
|
||
## Commerical Support | ||
|
||
Work directly with our team of DevOps experts via email, slack, and video conferencing. | ||
|
||
We provide *commercial support* for all of our [Open Source][github] projects. As a *Dedicated Support* customer, you have access to our team of subject matter experts at a fraction of the cost of a fulltime engineer. | ||
|
||
[](mailto:[email protected]) | ||
|
||
- **Questions.** We'll use a Shared Slack channel between your team and ours. | ||
- **Troubleshooting.** We'll help you triage why things aren't working. | ||
- **Code Reviews.** We'll review your Pull Requests and provide constructive feedback. | ||
- **Bug Fixes.** We'll rapidly work to fix any bugs in our projects. | ||
- **Build New Terraform Modules.** We'll develop original modules to provision infrastructure. | ||
- **Cloud Architecture.** We'll assist with your cloud strategy and design. | ||
- **Implementation.** We'll provide hands on support to implement our reference architectures. | ||
|
||
|
||
## Community Forum | ||
|
||
Get access to our [Open Source Community Forum][slack] on Slack. It's **FREE** to join for everyone! Our "SweetOps" community is where you get to talk with others who share a similar vision for how to rollout and manage infrastructure. This is the best place to talk shop, ask questions, solicit feedback, and work together as a community to build *sweet* infrastructure. | ||
|
||
## Contributing | ||
|
||
|
@@ -64,22 +124,28 @@ Please use the [issue tracker](https://github.com/cloudposse/terraform-aws-dynam | |
|
||
### Developing | ||
|
||
If you are interested in being a contributor and want to get involved in developing `terraform-aws-dynamodb-autoscaler`, we would love to hear from you! Shoot us an [email](mailto:[email protected]). | ||
If you are interested in being a contributor and want to get involved in developing this project or [help out](https://github.com/orgs/cloudposse/projects/3) with our other projects, we would love to hear from you! Shoot us an [email](mailto:[email protected]). | ||
|
||
In general, PRs are welcome. We follow the typical "fork-and-pull" Git workflow. | ||
|
||
1. **Fork** the repo on GitHub | ||
2. **Clone** the project to your own machine | ||
3. **Commit** changes to your own branch | ||
4. **Push** your work back up to your fork | ||
5. Submit a **Pull request** so that we can review your changes | ||
5. Submit a **Pull Request** so that we can review your changes | ||
|
||
**NOTE:** Be sure to merge the latest changes from "upstream" before making a pull request! | ||
|
||
|
||
**NOTE:** Be sure to merge the latest from "upstream" before making a pull request! | ||
## Copyright | ||
|
||
Copyright © 2017-2018 [Cloud Posse, LLC](https://cloudposse.com) | ||
|
||
## License | ||
|
||
[APACHE 2.0](LICENSE) © 2017-2018 [Cloud Posse, LLC](https://cloudposse.com) | ||
|
||
## License | ||
|
||
[](https://opensource.org/licenses/Apache-2.0) | ||
|
||
See [LICENSE](LICENSE) for full details. | ||
|
||
|
@@ -91,7 +157,7 @@ See [LICENSE](LICENSE) for full details. | |
"License"); you may not use this file except in compliance | ||
with the License. You may obtain a copy of the License at | ||
|
||
http://www.apache.org/licenses/LICENSE-2.0 | ||
https://www.apache.org/licenses/LICENSE-2.0 | ||
|
||
Unless required by applicable law or agreed to in writing, | ||
software distributed under the License is distributed on an | ||
|
@@ -101,31 +167,41 @@ See [LICENSE](LICENSE) for full details. | |
under the License. | ||
|
||
|
||
## Trademarks | ||
|
||
All other trademarks referenced herein are the property of their respective owners. | ||
|
||
## About | ||
|
||
`terraform-aws-dynamodb-autoscaler` is maintained and funded by [Cloud Posse, LLC][website]. | ||
This project is maintained and funded by [Cloud Posse, LLC][website]. Like it? Please let us know at <[email protected]> | ||
|
||
[](https://cloudposse.com) | ||
|
||
 | ||
We're a [DevOps Professional Services][hire] company based in Los Angeles, CA. We love [Open Source Software](https://github.com/cloudposse/)! | ||
|
||
We offer paid support on all of our projects. | ||
|
||
Like it? Please let us know at <[email protected]> | ||
Check out [our other projects][github], [apply for a job][jobs], or [hire us][hire] to help with your cloud strategy and implementation. | ||
|
||
We love [Open Source Software](https://github.com/cloudposse/)! | ||
[docs]: https://docs.cloudposse.com/ | ||
[website]: https://cloudposse.com/ | ||
[github]: https://github.com/cloudposse/ | ||
[jobs]: https://cloudposse.com/jobs/ | ||
[hire]: https://cloudposse.com/contact/ | ||
[slack]: https://slack.cloudposse.com/ | ||
[linkedin]: https://www.linkedin.com/company/cloudposse | ||
[twitter]: https://twitter.com/cloudposse/ | ||
[email]: mailto:[email protected] | ||
|
||
See [our other projects][community] | ||
or [hire us][hire] to help build your next cloud-platform. | ||
|
||
[website]: http://cloudposse.com/ | ||
[community]: https://github.com/cloudposse/ | ||
[hire]: http://cloudposse.com/contact/ | ||
### Contributors | ||
|
||
| [![Andriy Knysh][aknysh_avatar]][aknysh_homepage]<br/>[Andriy Knysh][aknysh_homepage] | [![Michele Cantelli][emmekappa_avatar]][emmekappa_homepage]<br/>[Michele Cantelli][emmekappa_homepage] | | ||
|---|---| | ||
|
||
## Contributors | ||
[aknysh_homepage]: https://github.com/aknysh | ||
[aknysh_avatar]: https://github.com/aknysh.png?size=150 | ||
[emmekappa_homepage]: https://github.com/emmekappa | ||
[emmekappa_avatar]: https://github.com/emmekappa.png?size=150 | ||
|
||
| [![Erik Osterman][erik_img]][erik_web]<br/>[Erik Osterman][erik_web] | [![Andriy Knysh][andriy_img]][andriy_web]<br/>[Andriy Knysh][andriy_web] | | ||
|-------------------------------------------------------|------------------------------------------------------------------| | ||
|
||
[erik_img]: http://s.gravatar.com/avatar/88c480d4f73b813904e00a5695a454cb?s=144 | ||
[erik_web]: https://github.com/osterman/ | ||
[andriy_img]: https://avatars0.githubusercontent.com/u/7356997?v=4&u=ed9ce1c9151d552d985bdf5546772e14ef7ab617&s=144 | ||
[andriy_web]: https://github.com/aknysh/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,74 @@ | ||
--- | ||
# | ||
# This is the canonical configuration for the `README.md` | ||
# Run `make readme` to rebuild the `README.md` | ||
# | ||
|
||
# Name of this project | ||
name: terraform-aws-dynamodb-autoscaler | ||
|
||
# Logo for this project | ||
#logo: docs/logo.png | ||
|
||
# License of this project | ||
license: "APACHE2" | ||
|
||
# Canonical GitHub repo | ||
github_repo: cloudposse/terraform-aws-dynamodb-autoscaler | ||
|
||
# Badges to display | ||
badges: | ||
- name: "Build Status" | ||
image: "https://travis-ci.org/cloudposse/terraform-aws-dynamodb-autoscaler.svg?branch=master" | ||
url: "https://travis-ci.org/cloudposse/terraform-aws-dynamodb-autoscaler" | ||
- name: "Latest Release" | ||
image: "https://img.shields.io/github/release/cloudposse/terraform-aws-dynamodb-autoscaler.svg" | ||
url: "https://github.com/cloudposse/terraform-aws-dynamodb-autoscaler/releases/latest" | ||
- name: "Slack Community" | ||
image: "https://slack.cloudposse.com/badge.svg" | ||
url: "https://slack.cloudposse.com" | ||
|
||
related: | ||
- name: "terraform-aws-dynamodb" | ||
description: "Terraform module that implements AWS DynamoDB with support for AutoScaling" | ||
url: "https://github.com/cloudposse/terraform-aws-dynamodb" | ||
- name: "terraform-aws-tfstate-backend" | ||
description: "Provision an S3 bucket to store terraform.tfstate file and a DynamoDB table to lock the state file to prevent concurrent modifications and state corruption" | ||
url: "https://github.com/cloudposse/terraform-aws-tfstate-backend" | ||
|
||
# Short description of this project | ||
description: |- | ||
Terraform module to provision DynamoDB autoscaler. | ||
Autoscaler scales up/down the provisioned OPS for a DynamoDB table based on the load. | ||
# How to use this project | ||
usage: |- | ||
```hcl | ||
module "dynamodb_autoscaler" { | ||
source = "git::https://github.com/cloudposse/terraform-aws-dynamodb-autoscaler.git?ref=master" | ||
namespace = "cp" | ||
stage = "dev" | ||
name = "cluster" | ||
dynamodb_table_name = "cp-dev-cluster-terraform-state-lock" | ||
dynamodb_indexes = [ "first-index", "second-index" ] | ||
dynamodb_table_arn = "arn:aws:dynamodb:us-east-1:123456789012:table/cp-dev-cluster-terraform-state-lock" | ||
autoscale_write_target = 50 | ||
autoscale_read_target = 50 | ||
autoscale_min_read_capacity = 5 | ||
autoscale_max_read_capacity = 20 | ||
autoscale_min_write_capacity = 5 | ||
autoscale_max_write_capacity = 20 | ||
} | ||
``` | ||
include: | ||
- "docs/targets.md" | ||
- "docs/terraform.md" | ||
|
||
# Contributors to this project | ||
contributors: | ||
- name: "Andriy Knysh" | ||
github: "aknysh" | ||
- name: "Michele Cantelli" | ||
github: "emmekappa" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
## Makefile Targets | ||
``` | ||
Available targets: | ||
help This help screen | ||
help/all Display help for all targets | ||
lint Lint terraform code | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
|
||
## Inputs | ||
|
||
| Name | Description | Type | Default | Required | | ||
|------|-------------|:----:|:-----:|:-----:| | ||
| attributes | Additional attributes (e.g. `1`) | list | `<list>` | no | | ||
| autoscale_max_read_capacity | DynamoDB autoscaling max read capacity | string | `20` | no | | ||
| autoscale_max_write_capacity | DynamoDB autoscaling max write capacity | string | `20` | no | | ||
| autoscale_min_read_capacity | DynamoDB autoscaling min read capacity | string | `5` | no | | ||
| autoscale_min_write_capacity | DynamoDB autoscaling min write capacity | string | `5` | no | | ||
| autoscale_read_target | The target value for DynamoDB read autoscaling | string | `50` | no | | ||
| autoscale_write_target | The target value for DynamoDB write autoscaling | string | `50` | no | | ||
| delimiter | Delimiter to be used between `namespace`, `stage`, `name` and `attributes` | string | `-` | no | | ||
| dynamodb_indexes | List of DynamoDB indexes | list | `<list>` | no | | ||
| dynamodb_table_arn | DynamoDB table ARN | string | - | yes | | ||
| dynamodb_table_name | DynamoDB table name | string | - | yes | | ||
| enabled | Set to false to prevent the module from creating any resources | string | `true` | no | | ||
| name | Name (e.g. `app` or `cluster`) | string | - | yes | | ||
| namespace | Namespace (e.g. `cp` or `cloudposse`) | string | - | yes | | ||
| stage | Stage (e.g. `prod`, `dev`, `staging`, `infra`) | string | - | yes | | ||
| tags | Additional tags (e.g. map(`BusinessUnit`,`XYZ`) | map | `<map>` | no | | ||
|