Skip to content
This repository was archived by the owner on Mar 29, 2023. It is now read-only.

Commit 0bd3c07

Browse files
authored
Merge pull request #53 from gruntwork-io/readme-updates
Update the README to the new format
2 parents b2c210b + a0aca02 commit 0bd3c07

File tree

5 files changed

+119
-76
lines changed

5 files changed

+119
-76
lines changed

.circleci/config.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,8 @@ jobs:
4444

4545
# Install external dependencies
4646
- run: DEBIAN_FRONTEND=noninteractive sudo apt-get update && sudo apt-get install -y python-pip
47-
- run: pip install pre-commit awscli
47+
# Oct 26, 2019: Install the last known working version of pre-commit
48+
- run: pip install pre-commit==1.11.2 awscli
4849

4950
# Fail the build if the pre-commit hooks don't pass. Note: if you run "pre-commit install" locally in the roo repo
5051
# folder, these hooks will execute automatically every time before you commit, ensuring the build never fails at this step!

.pre-commit-config.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
repos:
2-
- repo: git@github.com:gruntwork-io/module-ci.git
3-
sha: v0.7.1
2+
- repo: https://github.com/gruntwork-io/pre-commit
3+
rev: v0.0.2
44
hooks:
55
- id: terraform-fmt

README.md

Lines changed: 87 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,23 @@
1-
[![Maintained by Gruntwork.io](https://img.shields.io/badge/maintained%20by-gruntwork.io-%235849a6.svg)](https://gruntwork.io/?ref=repo_aws_couchbase)
2-
![Terraform Version](https://img.shields.io/badge/tf-%3E%3D0.12.0-blue.svg)
1+
<!--
2+
:type: service
3+
:name: Couchbase
4+
:description: Deploy a Couchbase cluster. Supports automatic bootstrapping, Sync Gateway, Web Console UI, cross-region replication, and auto healing.
5+
:icon: /_docs/couchbase-icon.png
6+
:category: other-data-stores
7+
:cloud: aws
8+
:tags: nosql
9+
:license: open-source
10+
:built-with: terraform, bash
11+
-->
312

413
# Couchbase AWS Module
514

6-
This repo contains a Module for deploying [Couchbase](https://www.couchbase.com/) on [AWS](https://aws.amazon.com/)
7-
using [Terraform](https://www.terraform.io/) and [Packer](https://www.packer.io/). Couchbase is a distributed NoSQL
8-
document database. This module supports running Couchbase as a single cluster:
15+
[![Maintained by Gruntwork.io](https://img.shields.io/badge/maintained%20by-gruntwork.io-%235849a6.svg)](https://gruntwork.io/?ref=repo_aws_couchbase)
16+
![Terraform Version](https://img.shields.io/badge/tf-%3E%3D0.12.0-blue.svg)
17+
18+
This repo contains a set of modules for deploying [Couchbase](https://www.couchbase.com/) on
19+
[AWS](https://aws.amazon.com/) using [Terraform](https://www.terraform.io/) and [Packer](https://www.packer.io/).
20+
Couchbase is a distributed NoSQL document database. This module supports running Couchbase as a single cluster:
921

1022
![Couchbase single-cluster architecture](https://github.com/gruntwork-io/terraform-aws-couchbase/blob/master/_docs/couchbase-single-cluster-architecture.png?raw=true)
1123

@@ -15,110 +27,112 @@ Or as multiple clusters for the various Couchbase services (data, management, se
1527

1628

1729

18-
## Quick start
1930

20-
If you want to quickly spin up a Couchbase cluster, you can run the simple example that is in the root of this repo.
21-
Check out [couchbase-cluster-simple example
22-
documentation](https://github.com/gruntwork-io/terraform-aws-couchbase/blob/master/examples/couchbase-cluster-simple)
23-
for instructions.
31+
## Features
32+
33+
* Deploy Couchbase and Sync Gateway.
34+
* Automatic bootstrapping.
35+
* Cross-region replication
36+
* Multi-dimensional scaling, allowing you to separately scale data, management, search, index, query, and Sync
37+
Gateway nodes.
38+
* Auto healing.
39+
* Web console UI.
40+
41+
2442

2543

44+
## Learn
2645

46+
This repo is maintained by [Gruntwork](https://www.gruntwork.io), and follows the same patterns as [the Gruntwork
47+
Infrastructure as Code Library](https://gruntwork.io/infrastructure-as-code-library/), a collection of reusable,
48+
battle-tested, production ready infrastructure code. You can read [How to use the Gruntwork Infrastructure as Code
49+
Library](https://gruntwork.io/guides/foundations/how-to-use-gruntwork-infrastructure-as-code-library/) for an overview
50+
of how to use modules maintained by Gruntwork!
2751

28-
## What's in this repo
52+
### Core concepts
2953

30-
This repo has the following folder structure:
54+
* [Couchbase documentation](https://docs.couchbase.com/home/index.html): The core documentation for Couchbase, inculding
55+
guides for administrators, developers, SQL developers, and mobile developers.
56+
* [Couchbase tutorials](https://docs.couchbase.com/tutorials/index.html): hands-on guides for getting started with
57+
Couchbase.
58+
* [Couchbase Security](https://docs.couchbase.com/server/6.0/learn/security/security-overview.html): overview of how to
59+
secure your Couchbase clusters.
3160

32-
* [root](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master): The root folder contains an example
33-
of how to deploy Couchbase as a single-cluster. See
34-
[couchbase-cluster-simple](https://github.com/gruntwork-io/terraform-aws-couchbase/blob/master/examples/couchbase-cluster-simple)
35-
for the documentation.
36-
* [modules](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules): This folder contains the
37-
main implementation code for this Module, broken down into multiple standalone submodules.
38-
* [examples](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/examples): This folder contains
39-
examples of how to use the submodules.
40-
* [test](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/test): Automated tests for the submodules
41-
and examples.
4261

62+
### Repo organization
4363

64+
Check out [How to use this repo](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/core-concepts.md#how-to-use-this-repo):
65+
for an overview.
4466

67+
* [modules](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules): the main implementation code for this repo, broken down into multiple standalone, orthogonal submodules.
68+
* [examples](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/examples): This folder contains working examples of how to use the submodules.
69+
* [test](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/test): Automated tests for the modules and examples.
70+
* [root](https://github.com/hashicorp/terraform-aws-couchbase/tree/master): The root folder is *an example* of how to use the submodules to deploy a Couchbase cluster. The Terraform Registry requires the root of every repo to contain Terraform code, so we've put one of the examples there. This example is great for learning and experimenting, but for production use, please use the underlying modules in the [modules folder](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules) directly.
4571

46-
## How to use this repo
4772

48-
The general idea is to:
4973

50-
1. Use the scripts in the
51-
[install-couchbase-server](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/install-couchbase-server) and
52-
[install-sync-gateway](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/install-sync-gateway)
53-
modules to create an AMI with Couchbase and Sync Gateway installed.
54-
55-
1. Deploy the AMI across one or more Auto Scaling Groups (ASG) using the [couchbase-cluster
56-
module](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/couchbase-cluster).
57-
58-
1. Configure each server in the ASGs to execute the
59-
[run-couchbase-server](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/run-couchbase-server) and/or
60-
[run-sync-gateway](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/run-sync-gateway)
61-
script during boot.
6274

63-
1. (Optional): Deploy a load balancer in front of the ASGs using the [load-balancer
64-
module](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/load-balancer).
75+
## Deploy
6576

66-
See the [examples folder](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/examples) for working
67-
sample code.
77+
### Non-production deployment (quick start for learning)
6878

79+
If you just want to try this repo out for experimenting and learning, check out the following resources:
6980

81+
* [examples folder](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/examples): The `examples` folder contains sample code optimized for learning, experimenting, and testing (but not production usage).
82+
* [quick start](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/core-concepts.md#quick-start): A quick
83+
start guide for this repo.
7084

85+
### Production deployment
7186

72-
## What's a Module?
87+
If you want to deploy this repo in production, check out the following resources:
7388

74-
A Module is a canonical, reusable, best-practices definition for how to run a single piece of infrastructure, such
75-
as a database or server cluster. Each Module is written using a combination of [Terraform](https://www.terraform.io/)
76-
and scripts (mostly bash) and include automated tests, documentation, and examples. It is maintained both by the open
77-
source community and companies that provide commercial support.
89+
* [Couchbase deployment guidelines](https://docs.couchbase.com/server/6.0/install/install-production-deployment.html):
90+
A guide on how to configure Couchbase for production. All of these settings are exposed by the modules in the
91+
`modules` folder.
92+
* [Security options](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/couchbase-cluster/README.md#security):
93+
The security options you can configure using these modules.
94+
* [Credentials](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/run-couchbase-server/README.md#passing-credentials-securely):
95+
How to pass credentials securely to your Couchbase server.
96+
* [Memory settings](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/run-couchbase-server/README.md#memory-settings):
97+
How to configure memory settings in your Couchbase server.
98+
7899

79-
Instead of figuring out the details of how to run a piece of infrastructure from scratch, you can reuse
80-
existing code that has been proven in production. And instead of maintaining all that infrastructure code yourself,
81-
you can leverage the work of the Module community to pick up infrastructure improvements through
82-
a version number bump.
83-
84-
85-
86-
## Who maintains this Module?
87100

88-
This Module is maintained by [Gruntwork](http://www.gruntwork.io/). If you're looking for help or commercial
89-
support, send an email to [[email protected]](mailto:[email protected]?Subject=Couchbase%20for%20AWS%20Module).
90-
Gruntwork can help with:
91101

92-
* Setup, customization, and support for this Module.
93-
* Modules for other types of infrastructure, such as VPCs, Docker clusters, databases, and continuous integration.
94-
* Modules that meet compliance requirements, such as HIPAA.
95-
* Consulting & Training on AWS, Terraform, and DevOps.
102+
## Manage
96103

104+
### Day-to-day operations
97105

106+
* [How to connect to Sync Gateway](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/couchbase-cluster/README.md#connecting-to-sync-gateway)
107+
* [How to connect to the Couchbase Web Console](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/couchbase-cluster/README.md#connecting-to-the-couchbase-server-web-console)
108+
* [How to connect to the Couchbase Server via SDK](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/couchbase-cluster/README.md#connecting-to-couchbase-server-via-the-sdk)
98109

110+
### Major changes
99111

100-
## How do I contribute to this Module?
112+
* [How to upgrade a Couchbase cluster](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/modules/couchbase-cluster/README.md#how-do-you-roll-out-updates)
101113

102-
Contributions are very welcome! Check out the
103-
[Contribution Guidelines](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/CONTRIBUTING.md) for instructions.
104114

105115

106116

107-
## How is this Module versioned?
117+
## Support
108118

109-
This Module follows the principles of [Semantic Versioning](http://semver.org/). You can find each new release,
110-
along with the changelog, in the [Releases Page](../../releases).
119+
If you need help with this repo or anything else related to infrastructure or DevOps, Gruntwork offers [Commercial Support](https://gruntwork.io/support/) via Slack, email, and phone/video. If you're already a Gruntwork customer, hop on Slack and ask away! If not, [subscribe now](https://www.gruntwork.io/pricing/). If you're not sure, feel free to email us at [[email protected]](mailto:[email protected]).
120+
121+
122+
123+
124+
## Contributions
125+
126+
Contributions to this repo are very welcome and appreciated! If you find a bug or want to add a new feature or even contribute an entirely new module, we are very happy to accept pull requests, provide feedback, and run your changes through our automated test suite.
127+
128+
Please see [CONTRIBUTING.md](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/CONTRIBUTING.md) for instructions.
111129

112-
During initial development, the major version will be 0 (e.g., `0.x.y`), which indicates the code does not yet have a
113-
stable API. Once we hit `1.0.0`, we will make every effort to maintain a backwards compatible API and use the MAJOR,
114-
MINOR, and PATCH versions on each release to indicate any incompatibilities.
115130

116131

117132

118133
## License
119134

120-
This code is released under the Apache 2.0 License. Please see
121-
[LICENSE](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/LICENSE) and
122-
[NOTICE](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/NOTICE) for more details.
135+
Please see [LICENSE](https://github.com/hashicorp/terraform-aws-couchbase/tree/master/LICENSE) for details on how the code in this repo is licensed.
136+
123137

124-
Copyright &copy; 2018 Gruntwork, Inc.
138+
Copyright &copy; 2019 Gruntwork, Inc.

_docs/couchbase-icon.png

9.72 KB
Loading

core-concepts.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Core concepts
2+
3+
## Quick start
4+
5+
If you want to quickly spin up a Couchbase cluster, you can run the simple example that is in the root of this repo.
6+
Check out [couchbase-cluster-simple example
7+
documentation](https://github.com/gruntwork-io/terraform-aws-couchbase/blob/master/examples/couchbase-cluster-simple)
8+
for instructions.
9+
10+
## How to use this repo
11+
12+
The general idea is to:
13+
14+
1. Use the scripts in the
15+
[install-couchbase-server](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/install-couchbase-server) and
16+
[install-sync-gateway](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/install-sync-gateway)
17+
modules to create an AMI with Couchbase and Sync Gateway installed.
18+
19+
1. Deploy the AMI across one or more Auto Scaling Groups (ASG) using the [couchbase-cluster
20+
module](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/couchbase-cluster).
21+
22+
1. Configure each server in the ASGs to execute the
23+
[run-couchbase-server](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/run-couchbase-server) and/or
24+
[run-sync-gateway](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/run-sync-gateway)
25+
script during boot.
26+
27+
1. (Optional): Deploy a load balancer in front of the ASGs using the [load-balancer
28+
module](https://github.com/gruntwork-io/terraform-aws-couchbase/tree/master/modules/load-balancer).

0 commit comments

Comments
 (0)