Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/particuleio/terraform-scaleway-database
Terraform module to create and configure Scaleway Databases. Create RDB instances with managed databases, user creation and ACLs support.
https://github.com/particuleio/terraform-scaleway-database
cloud database iac infrastructure-as-code mysql postgresql scaleway scaleway-rdb sql terraform terraform-module
Last synced: about 5 hours ago
JSON representation
Terraform module to create and configure Scaleway Databases. Create RDB instances with managed databases, user creation and ACLs support.
- Host: GitHub
- URL: https://github.com/particuleio/terraform-scaleway-database
- Owner: particuleio
- Created: 2021-10-13T13:28:07.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T16:20:05.000Z (2 months ago)
- Last Synced: 2024-09-09T20:19:31.921Z (2 months ago)
- Topics: cloud, database, iac, infrastructure-as-code, mysql, postgresql, scaleway, scaleway-rdb, sql, terraform, terraform-module
- Language: HCL
- Homepage: https://registry.terraform.io/modules/particuleio/database/scaleway/
- Size: 98.6 KB
- Stars: 5
- Watchers: 5
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# terraform-scaleway-database
[](https://github.com/particuleio/terraform-scaleway-database/actions/workflows/terraform.yml)
Terraform module to create Databases using Scaleway's [Managed Databases][scw-db].
Create and configure the following:
- Managed RDB Instances
- Database Users
- Database ACLs
- Managed Databases
[scw-db]: https://www.scaleway.com/en/database/
## Usage
The module takes a `map` of objects for each database to configure.
```hcl
# example with a single RDB instance configured with 2 managed databases
module "database" {
source = "particuleio/database/scaleway"
version = "1.2.0" # use latest version
databases = {
main = {
node_type = "DB-DEV-S"
engine = "PostgreSQL-11"
dbs = ["default", "core"]
}
}
}
```
The `locals.tf` defines default values that are merged and overriden
by each `database` definition in the `databases` `map`.
### Examples
Multiple examples are available in the [`./examples`](./examples) directory.
- [A simple database setup](./examples/simple/)
- [Multiple database creation with users](./examples/users/)
- [Database creation with ACL support](./examples/acls/)
- [RDB instance with multiple databases](./examples/databases/)
Below is an advanced usage of this module.
```hcl
module "database" {
source = "particuleio/database/scaleway"
version = "1.2.0" # use latest version
databases = {
main = {
name = "database-with-multiple-dbs"
node_type = "DB-DEV-S"
engine = "PostgreSQL-11"
dbs = ["default", "admin", "internal"]
acls = [
{
ip = "1.2.3.4/32"
description = "Specific ACL 1"
},
{
ip = "192.168.1.20/28"
description = "Specific ACL 2"
},
]
users = [
{
username = "application"
password_length = 16
is_admin = false
},
{
username = "administrator"
password_length = 24
is_admin = true
},
]
}
metrics = { # second RDB instance definition
name = "simple-database"
node_type = "DB-DEV-S"
engine = "PostgreSQL-11"
}
}
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 0.13 |
| [scaleway](#requirement\_scaleway) | ~> 2.0 |
## Providers
| Name | Version |
|------|---------|
| [random](#provider\_random) | n/a |
| [scaleway](#provider\_scaleway) | ~> 2.0 |
## Modules
No modules.
## Resources
| Name | Type |
|------|------|
| [random_password.this](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/password) | resource |
| [scaleway_rdb_acl.this](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/rdb_acl) | resource |
| [scaleway_rdb_database.this](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/rdb_database) | resource |
| [scaleway_rdb_instance.this](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/rdb_instance) | resource |
| [scaleway_rdb_user.this](https://registry.terraform.io/providers/scaleway/scaleway/latest/docs/resources/rdb_user) | resource |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [databases](#input\_databases) | The scaleway Database configurations | `map(any)` | n/a | yes |
| [region](#input\_region) | Region to be used with the scaleway provider | `string` | `"fr-par"` | no |
| [zone](#input\_zone) | Zone to be used with the scaleway provider | `string` | `"fr-par-1"` | no |
## Outputs
| Name | Description |
|------|-------------|
| [databases](#output\_databases) | A map of each created scaleway\_rdb\_instance with each `var.databases` definition as key |
| [instances](#output\_instances) | A map of each created scaleway\_rdb\_instance with each `var.databases` definition as key |
| [this](#output\_this) | A map of the scaleway\_rdb\_database (including their users) and scaleway\_rdb\_instance resources grouped by databases definitions |