JSM Operations Terraform Modules

This repository contains Terraform modules for managing Jira Service Management (JSM) Operations resources in a consistent and automated way. The modules centralize configuration for teams, integrations, alert policies, and notification policies, ensuring governance and reusability across environments.

Overview

These modules provide a standardized way to manage JSM Operations infrastructure using the Atlassian Operations Terraform Provider. Each module is designed to be reusable, well-documented, and follows Terraform best practices.

Available Modules

• team - Create and manage JSM Operations teams and their members
• alert_policy - Define and manage alert policies for incident routing
• notification_policy - Configure user/team notification rules and auto-close actions
• api_integration - Manage API integrations for external systems
• email_integration - Manage email integrations for alert ingestion
• integration_action - Define integration actions for processing alerts and incidents

Requirements

• Terraform >= 1.5.0
• Atlassian Operations Provider ~> 1.0
• JSM Operations API Key with required permissions

Quick Start

Provider Configuration

Configure the Atlassian Operations provider in your Terraform configuration:

terraform {
  required_providers {
    atlassian-operations = {
      source  = "registry.terraform.io/atlassian/atlassian-operations"
      version = "~> 1.0"
    }
  }
}

provider "atlassian-operations" {
  api_key = var.jsm_ops_api_key
  # Optional: base_url = "https://api.atlassian.com"
}

Example Usage

module "team" {
  source = "./team"

  organization_id = "your-org-id"
  team = {
    display_name = "Platform Engineering"
    description  = "Platform engineering team"
    members = [
      { id = "account-id-1" },
      { id = "account-id-2" }
    ]
  }
}

module "alert_policy" {
  source = "./alert_policy"

  alert_policy = {
    name        = "Critical Alerts"
    description = "Route critical alerts to on-call team"
    enabled     = true
    filter = {
      type = "match-all"
      conditions = [
        {
          field          = "priority"
          operation      = "equals"
          expected_value = "P1"
        }
      ]
    }
    actions = ["notify-team"]
  }
}

Module Documentation

Each module includes detailed documentation:

• Team Module
• Alert Policy Module
• Notification Policy Module
• API Integration Module
• Email Integration Module
• Integration Action Module

Examples

See the examples directory for complete usage examples of each module and how to combine multiple modules together.

Authentication

The modules require a JSM Operations API key. You can obtain this from your Atlassian organization settings. Set it as an environment variable or in your Terraform variables:

export ATLASSIAN_OPERATIONS_API_KEY="your-api-key"

Or use a Terraform variable:

variable "jsm_ops_api_key" {
  description = "JSM Operations API Key"
  type        = string
  sensitive   = true
}

Resources

• Atlassian Operations Provider Documentation
• Provider GitHub Repository
• JSM Operations Documentation

Contributing

Contributions are welcome! Please ensure that:

• All modules follow the established structure and naming conventions
• Documentation is updated for any changes
• Examples are provided for new features
• Code follows Terraform best practices

License

See LICENSE file for details.