Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ably/terraform-provider-ably
Ably's Terraform Provider, enabling you to manage your Ably account programmatically.
https://github.com/ably/terraform-provider-ably
sdk terraform terraform-provider
Last synced: 3 days ago
JSON representation
Ably's Terraform Provider, enabling you to manage your Ably account programmatically.
- Host: GitHub
- URL: https://github.com/ably/terraform-provider-ably
- Owner: ably
- License: apache-2.0
- Created: 2022-07-11T09:26:11.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-12T15:04:06.000Z (2 months ago)
- Last Synced: 2024-09-13T03:09:35.444Z (2 months ago)
- Topics: sdk, terraform, terraform-provider
- Language: Go
- Homepage: https://registry.terraform.io/providers/ably/ably
- Size: 493 KB
- Stars: 11
- Watchers: 23
- Forks: 2
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Ably Terraform Provider
_[Ably](https://ably.com) 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](https://ably.com/docs)._
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.
## Supported platforms
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: https://www.terraform.io/plugin/how-terraform-works#protocol-version-6).
## Installation
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](https://ably.com/docs/control-api#authentication).
2. Set the environment variable `ABLY_ACCOUNT_TOKEN` to the token you have created.
3. Add the following to your Terraform configuration file
```terraform
terraform {
required_providers {
ably = {
source = "ably/ably"
version = "0.6.1"
}
}
}
provider "ably" {
}
```
4. (Optional) Alternatively you can also specify Control API token in the provider configuration directly:
```terraform
provider "ably" {
token =
}
```
## Using Ably Terraform provider
This readme gives a basic example; for more examples see the [examples/](examples/) folder, rendered documentation on the Terraform Registry, or [docs folder](docs/) in this repository.
```terraform
# 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"
}
```
## Dependencies
This provider uses [Ably Control API](https://ably.com/docs/api/control-api) and [Ably Control Go SDK](https://github.com/ably/ably-control-go) under the hood.
## Support, feedback and troubleshooting
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](https://github.com/ably/terraform-provider-ably/issues).
To see what has changed in recent versions, see the [CHANGELOG](CHANGELOG.md).
## Contributing
For guidance on how to contribute to this project, see the [CONTRIBUTING.md](CONTRIBUTING.md).