{"id":24355539,"url":"https://github.com/rootlyhq/terraform-provider-rootly","last_synced_at":"2026-03-11T02:17:40.715Z","repository":{"id":37884221,"uuid":"466280518","full_name":"rootlyhq/terraform-provider-rootly","owner":"rootlyhq","description":"Terraform provider for Rootly - manage incident management, on-call schedules, workflows, and alerts as code","archived":false,"fork":false,"pushed_at":"2026-03-01T04:22:48.000Z","size":5838,"stargazers_count":17,"open_issues_count":20,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-03-01T06:43:16.262Z","etag":null,"topics":["devops","go","golang","hashicorp","iac","incident-management","incident-response","infrastructure-as-code","on-call","rootly","site-reliability-engineering","sre","terraform","terraform-provider"],"latest_commit_sha":null,"homepage":"https://registry.terraform.io/providers/rootlyhq/rootly","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rootlyhq.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-04T21:53:38.000Z","updated_at":"2026-02-27T15:58:52.000Z","dependencies_parsed_at":"2025-12-16T02:06:18.139Z","dependency_job_id":null,"html_url":"https://github.com/rootlyhq/terraform-provider-rootly","commit_stats":null,"previous_names":[],"tags_count":262,"template":false,"template_full_name":null,"purl":"pkg:github/rootlyhq/terraform-provider-rootly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootlyhq%2Fterraform-provider-rootly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootlyhq%2Fterraform-provider-rootly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootlyhq%2Fterraform-provider-rootly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootlyhq%2Fterraform-provider-rootly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rootlyhq","download_url":"https://codeload.github.com/rootlyhq/terraform-provider-rootly/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootlyhq%2Fterraform-provider-rootly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30367811,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"online","status_checked_at":"2026-03-11T02:00:07.027Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devops","go","golang","hashicorp","iac","incident-management","incident-response","infrastructure-as-code","on-call","rootly","site-reliability-engineering","sre","terraform","terraform-provider"],"created_at":"2025-01-18T17:57:42.831Z","updated_at":"2026-03-11T02:17:40.698Z","avatar_url":"https://github.com/rootlyhq.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rootly Provider\n\nThe [Rootly](https://rootly.com/) provider is used to interact with the resources supported by Rootly. The provider needs to be configured with the proper credentials before it can be used. It requires terraform 1.0 or later.\n\n## Usage\n\nPlease see the [Terraform Registry documentation](https://registry.terraform.io/providers/rootlyhq/rootly/latest/docs) or [examples/](examples).\n\n```terraform\nterraform {\n  required_providers {\n    rootly = {\n      source = \"rootlyhq/rootly\"\n    }\n  }\n}\n\nprovider \"rootly\" {\n  # We recommend using the `ROOTLY_API_TOKEN` env var to set the API Token\n  # when interacting with Rootly's API.\n  # api_token = var.rootly_api_key\n}\n```\n\n## Migration Script\n\nA migration script is available to help migrate from deprecated Rootly resources to their newer equivalents. The script automates the process of fetching existing resources via the Rootly API and generating Terraform configurations with import statements.\n\n**Currently supported migrations:**\n- `alert_routing_rules_to_alert_routes` - Migrate from deprecated `rootly_alert_routing_rule` to `rootly_alert_route`\n\nFor detailed usage instructions, see [Migration Script Documentation](scripts/migration/README.md).\n\n## Develop\n\n### Build Commands\n\n| Command | Description |\n|---------|-------------|\n| `make build` | Complete build: generate code, compile provider, regenerate docs |\n| `make codegen` | Download schema and auto-generate client code and provider resources |\n| `make codegen \u003cRESOURCE=resource_name\u003e`| Download schema and auto-generate client code and provider for the named resource | \n| `make docs` | Regenerate Terraform documentation from provider schemas |\n| `make test` | Run unit tests |\n| `make testacc` | Run acceptance tests |\n| `make help` | Show all available commands |\n\n### Test your changes\n\nTest your changes by running the acceptance tests.\n\nFor example, to test alerts source resource in `provider/resource_alerts_source_test.go`:\n\n```\nROOTLY_API_TOKEN=\"xxx\" make testacc TESTARGS=\"-run TestAccResourceAlertsSource\"\n```\n\nTo run the tests pointed at an API URL of your choice set the `ROOTLY_API_URL` environment variable.\n\nTo enable debug logs set `TF_LOG=DEBUG`.\n\n### Updating provider\n\n`make build` auto-generates code from Rootly's JSON-API schema, compiles provider code, and regenerates docs.\n\nSome API resources are excluded from code generation if they are in the ignore-lists in `tools/generate.js`. If so, those resources will need to be updated manually.\n\nTests are often not able to be code generated. If so, add them to the ignore-list in `tools/generate.js` and implement manually.\n\n### Version Management\n\nThe project uses [semantic versioning](https://semver.org) with git tags. Use these commands to manage versions:\n\n#### Version Commands\n```bash\nmake version-show      # Show current and next versions\nmake version-patch     # Bump patch version (1.2.3 → 1.2.4)\nmake version-minor     # Bump minor version (1.2.3 → 1.3.0)  \nmake version-major     # Bump major version (1.2.3 → 2.0.0)\n```\n\n#### Release Commands\n```bash\nmake release-patch     # Bump patch version + push tag (triggers CI release)\nmake release-minor     # Bump minor version + push tag (triggers CI release)\nmake release-major     # Bump major version + push tag (triggers CI release)\n```\n\n#### Example Usage\n```bash\n# Check current version\nmake version-show\n# Current version: v3.1.0\n# Next patch: 3.1.1\n\n# Bump patch version\nmake version-patch\n# Creates and pushes v3.1.1 tag\n\n# Or bump and push tag in one step (triggers CI release)\nmake release-patch\n# Bumps to v3.1.1, pushes tag, CI builds and publishes release\n```\n\n**Important**: Use the `make version-*` commands instead of manually creating git tags. This ensures version consistency and proper validation.\n\n### Release / Publish to Terraform Registry\n\nReleases are automatically published to Terraform Registry when a new tag is pushed. The version management commands above handle this process:\n\n1. **Version Bumping**: `make version-*` commands create and push git tags\n2. **CI Trigger**: Pushed tags trigger CI/GoReleaser workflow \n3. **Automatic Release**: CI builds and publishes releases to GitHub and Terraform Registry\n4. **Version Injection**: The correct version is automatically set in the provider binary during CI build\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootlyhq%2Fterraform-provider-rootly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frootlyhq%2Fterraform-provider-rootly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootlyhq%2Fterraform-provider-rootly/lists"}