2020-05-11 08:51:00 -07:00
# Google Cloud Pub/Sub Module
2022-11-20 04:26:33 -08:00
This module allows managing a single Pub/Sub topic, including multiple subscriptions and IAM bindings at the topic and subscriptions levels, as well as schemas.
2020-05-11 08:51:00 -07:00
## Examples
### Simple topic with IAM
```hcl
module "pubsub" {
2022-09-06 08:46:09 -07:00
source = "./fabric/modules/pubsub"
2020-05-28 23:08:09 -07:00
project_id = "my-project"
2020-05-11 08:51:00 -07:00
name = "my-topic"
2020-11-05 12:28:34 -08:00
iam = {
2020-05-11 08:51:00 -07:00
"roles/pubsub.viewer" = ["group:foo@example.com"]
"roles/pubsub.subscriber" = ["user:user1@example.com"]
}
2020-05-28 23:07:08 -07:00
}
2023-04-14 08:14:02 -07:00
# tftest modules=1 resources=3 inventory=simple.yaml
2020-05-11 08:51:00 -07:00
```
2022-11-20 04:26:33 -08:00
### Topic with schema
```hcl
module "topic_with_schema" {
source = "./fabric/modules/pubsub"
project_id = "my-project"
name = "my-topic"
schema = {
msg_encoding = "JSON"
2022-12-16 03:53:56 -08:00
schema_type = "AVRO"
2022-11-20 04:26:33 -08:00
definition = jsonencode({
"type" = "record",
"name" = "Avro",
2022-11-20 07:36:36 -08:00
"fields" = [{
2022-11-20 04:26:33 -08:00
"name" = "StringField",
"type" = "string"
},
{
"name" = "FloatField",
"type" = "float"
},
{
"name" = "BooleanField",
"type" = "boolean"
},
]
})
}
}
2023-04-14 08:14:02 -07:00
# tftest modules=1 resources=2 inventory=schema.yaml
2022-11-20 04:26:33 -08:00
```
2020-05-11 08:51:00 -07:00
### Subscriptions
Subscriptions are defined with the `subscriptions` variable, allowing optional configuration of per-subscription defaults. Push subscriptions need extra configuration, shown in the following example.
```hcl
module "pubsub" {
2022-09-06 08:46:09 -07:00
source = "./fabric/modules/pubsub"
2020-11-06 00:36:32 -08:00
project_id = "my-project"
2020-05-11 08:51:00 -07:00
name = "my-topic"
subscriptions = {
test-pull = null
test-pull-override = {
labels = { test = "override" }
options = {
ack_deadline_seconds = null
message_retention_duration = null
retain_acked_messages = true
expiration_policy_ttl = null
2022-04-30 02:25:50 -07:00
filter = null
2020-05-11 08:51:00 -07:00
}
}
}
}
2023-04-14 08:14:02 -07:00
# tftest modules=1 resources=3 inventory=subscriptions.yaml
2020-05-11 08:51:00 -07:00
```
### Push subscriptions
Push subscriptions need extra configuration in the `push_configs` variable.
```hcl
module "pubsub" {
2022-09-06 08:46:09 -07:00
source = "./fabric/modules/pubsub"
2020-11-06 00:36:32 -08:00
project_id = "my-project"
2020-05-11 08:51:00 -07:00
name = "my-topic"
subscriptions = {
test-push = null
}
push_configs = {
test-push = {
endpoint = "https://example.com/foo"
attributes = null
oidc_token = null
}
}
}
2022-01-28 11:15:35 -08:00
# tftest modules=1 resources=2
2020-05-11 08:51:00 -07:00
```
2022-11-21 08:43:17 -08:00
### BigQuery subscriptions
BigQuery subscriptions need extra configuration in the `bigquery_subscription_configs` variable.
```hcl
module "pubsub" {
source = "./fabric/modules/pubsub"
project_id = "my-project"
name = "my-topic"
subscriptions = {
test-bigquery = null
}
bigquery_subscription_configs = {
test-bigquery = {
table = "my_project_id:my_dataset.my_table"
use_topic_schema = true
write_metadata = false
drop_unknown_fields = true
}
}
}
# tftest modules=1 resources=2
```
2023-09-13 06:13:13 -07:00
### Cloud Storage subscriptions
Cloud Storage subscriptions need extra configuration in the `cloud_storage_subscription_configs` variable.
```hcl
module "pubsub" {
source = "./fabric/modules/pubsub"
pproject_id = "my-project"
name = "my-topic"
subscriptions = {
test-cloudstorage = null
}
cloud_storage_subscription_configs = {
test-cloudstorage = {
bucket = "my-bucket"
filename_prefix = "test_prefix"
filename_suffix = "test_suffix"
max_duration = "100s"
max_bytes = 1000
avro_config = {
write_metadata = true
}
}
}
}
# tftest modules=1 resources=2
```
2020-05-11 08:51:00 -07:00
### Subscriptions with IAM
```hcl
module "pubsub" {
2022-09-06 08:46:09 -07:00
source = "./fabric/modules/pubsub"
2020-11-06 00:36:32 -08:00
project_id = "my-project"
2020-05-11 08:51:00 -07:00
name = "my-topic"
subscriptions = {
test-1 = null
test-1 = null
}
2020-11-05 12:28:34 -08:00
subscription_iam = {
2020-05-11 08:51:00 -07:00
test-1 = {
"roles/pubsub.subscriber" = ["user:user1@ludomagno.net"]
}
}
}
2022-01-28 11:15:35 -08:00
# tftest modules=1 resources=3
2020-05-11 08:51:00 -07:00
```
<!-- BEGIN TFDOC -->
## Variables
| name | description | type | required | default |
2021-12-20 23:51:51 -08:00
|---|---|:---:|:---:|:---:|
2023-09-13 06:13:13 -07:00
| [name ](variables.tf#L94 ) | PubSub topic name. | < code > string</ code > | ✓ | |
| [project_id ](variables.tf#L99 ) | Project used for resources. | < code > string</ code > | ✓ | |
2022-11-21 08:43:17 -08:00
| [bigquery_subscription_configs ](variables.tf#L17 ) | Configuration parameters for BigQuery subscriptions. | < code title = "map(object({ table = string use_topic_schema = bool write_metadata = bool drop_unknown_fields = bool }))" > map( object({…})) </ code > | | < code > {} </ code > |
2023-09-13 06:13:13 -07:00
| [cloud_storage_subscription_configs ](variables.tf#L28 ) | Configuration parameters for Cloud Storage subscriptions. | < code title = "map(object({ bucket = string filename_prefix = string filename_suffix = string max_duration = string max_bytes = number avro_config = object({ write_metadata = bool }) }))" > map( object({…})) </ code > | | < code > {} </ code > |
| [dead_letter_configs ](variables.tf#L43 ) | Per-subscription dead letter policy configuration. | < code title = "map(object({ topic = string max_delivery_attempts = number }))" > map( object({…})) </ code > | | < code > {} </ code > |
| [defaults ](variables.tf#L52 ) | Subscription defaults for options. | < code title = "object({ ack_deadline_seconds = number message_retention_duration = string retain_acked_messages = bool expiration_policy_ttl = string filter = string })" > object({…}) </ code > | | < code title = "{ ack_deadline_seconds = null message_retention_duration = null retain_acked_messages = null expiration_policy_ttl = null filter = null }" > {…} </ code > |
| [iam ](variables.tf#L70 ) | IAM bindings for topic in {ROLE => [MEMBERS]} format. | < code > map( list( string)) </ code > | | < code > {} </ code > |
| [kms_key ](variables.tf#L76 ) | KMS customer managed encryption key. | < code > string</ code > | | < code > null</ code > |
| [labels ](variables.tf#L82 ) | Labels. | < code > map( string) </ code > | | < code > {} </ code > |
| [message_retention_duration ](variables.tf#L88 ) | Minimum duration to retain a message after it is published to the topic. | < code > string</ code > | | < code > null</ code > |
| [push_configs ](variables.tf#L104 ) | Push subscription configurations. | < code title = "map(object({ attributes = map(string) endpoint = string oidc_token = object({ audience = string service_account_email = string }) }))" > map( object({…})) </ code > | | < code > {} </ code > |
| [regions ](variables.tf#L117 ) | List of regions used to set persistence policy. | < code > list( string) </ code > | | < code > [] </ code > |
| [schema ](variables.tf#L123 ) | Topic schema. If set, all messages in this topic should follow this schema. | < code title = "object({ definition = string msg_encoding = optional(string, "ENCODING_UNSPECIFIED") schema_type = string })" > object({…}) </ code > | | < code > null</ code > |
| [subscription_iam ](variables.tf#L133 ) | IAM bindings for subscriptions in {SUBSCRIPTION => {ROLE => [MEMBERS]}} format. | < code > map( map( list( string))) </ code > | | < code > {} </ code > |
| [subscriptions ](variables.tf#L139 ) | Topic subscriptions. Also define push configs for push subscriptions. If options is set to null subscription defaults will be used. Labels default to topic labels if set to null. | < code title = "map(object({ labels = map(string) options = object({ ack_deadline_seconds = number message_retention_duration = string retain_acked_messages = bool expiration_policy_ttl = string filter = string }) }))" > map( object({…})) </ code > | | < code > {} </ code > |
2020-05-11 08:51:00 -07:00
## Outputs
| name | description | sensitive |
|---|---|:---:|
2023-06-02 07:07:22 -07:00
| [id ](outputs.tf#L17 ) | Fully qualified topic id. | |
2023-03-02 01:21:52 -08:00
| [schema ](outputs.tf#L26 ) | Schema resource. | |
| [schema_id ](outputs.tf#L31 ) | Schema resource id. | |
| [subscription_id ](outputs.tf#L36 ) | Subscription ids. | |
| [subscriptions ](outputs.tf#L46 ) | Subscription resources. | |
| [topic ](outputs.tf#L54 ) | Topic resource. | |
2020-05-11 08:51:00 -07:00
<!-- END TFDOC -->