Ably is the platform that powers synchronized digital experiences in realtime. Whether attending an event in a virtual venue, receiving realtime financial information, or monitoring live car performance data – consumers simply expect realtime digital experiences as standard. Ably provides a suite of APIs to build, extend, and deliver powerful digital experiences in realtime for more than 250 million devices across 80 countries each month. Organizations like Bloomberg, HubSpot, Verizon, and Hopin depend on Ably’s platform to offload the growing complexity of business-critical realtime data synchronization at global scale. For more information, see the Ably documentation.
This is a Terraform provider for Ably that enables you to manage your Ably account using IaC (Infrastructure-as-Code), including managing your applications, namespaces, keys, queues, rules and more.
This provider supports the following systems/architectures:
This provider is built on top of Terraform Protocol 6.0, which is compatible with Terraform CLI version 1.0 and later (see more: https://www.terraform.io/plugin/how-terraform-works#protocol-version-6).
To install Ably Terraform provider:
ABLY_ACCOUNT_TOKEN
to the token you have created.terraform {
required_providers {
ably = {
source = "ably/ably"
version = "0.6.1"
}
}
}
provider "ably" {
}
provider "ably" {
token = <Control API token>
}
This readme gives a basic example; for more examples see the examples/ folder, rendered documentation on the Terraform Registry, or docs folder in this repository.
# Define Ably app
resource "ably_app" "app0" {
name = "ably-tf-provider-app-0000"
status = "enabled"
tls_only = true
}
# Add a key
resource "ably_api_key" "api_key_0" {
app_id = ably_app.app0.id
name = "key-0000"
capabilities = {
"channel2" = ["publish"],
"channel3" = ["subscribe"],
"channel33" = ["subscribe"],
}
}
# Configure a queue
resource "ably_queue" "example_queue" {
app_id = ably_app.app0.id
name = "queue_name"
ttl = 60
max_length = 10000
region = "us-east-1-a"
}
This provider uses Ably Control API and Ably Control Go SDK under the hood.
Please visit http://support.ably.com/ for access to our knowledgebase and to ask for any assistance.
You can also view the community reported Github issues.
To see what has changed in recent versions, see the CHANGELOG.
For guidance on how to contribute to this project, see the CONTRIBUTING.md.