Ably Terraform Provider

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:

• Darwin / AMD64
• Darwin / ARMv8
• Linux / AMD64 (this is required for usage in Terraform Cloud, see below)
• Linux / ARMv8 (sometimes referred to as AArch64 or ARM64)
• Linux / ARMv6
• Windows / AMD64

This provider is built on top of Terraform Protocol 6.0, which is compatible with Terraform CLI version 1.0 and later (see more: Terraform Plugin Protocol v6).

To install Ably Terraform provider:

1. Create a Control API token by logging into your Ably account and going to https://ably.com/users/access_tokens (Account -> My Access Tokens). This token should have permissions for the operations that you plan to do with Terraform provider. More details are available in Ably documentation.
2. Set the environment variable ABLY_ACCOUNT_TOKEN to the token you have created.
3. Add the following to your Terraform configuration file

terraform {
  required_providers {
    ably = {
      source  = "ably/ably"
      version = "1.0.0"
    }
  }
}

provider "ably" {
}

4. (Optional) Alternatively you can also specify Control API token in the provider configuration directly. This is not recommended and risks secret leakage should this file ever be committed to a public version control system:

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 the Ably Control API via the control Go client module in this repository, which replaced the standalone ably-control-go SDK.

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.