wehub-resource-sync
4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
93 lines
2.5 KiB
Plaintext
93 lines
2.5 KiB
Plaintext
---
|
|
title: "Jira"
|
|
description: "Connect Jira so OpenSRE can create and update incident tickets automatically"
|
|
---
|
|
|
|
OpenSRE connects to Jira to create incident tickets, update existing issues, and add investigation findings as comments — keeping your team's workflow in sync with automated investigations.
|
|
|
|
## Prerequisites
|
|
|
|
- Jira Cloud account (Jira Server/Data Center also supported)
|
|
- API token and project access
|
|
|
|
## Setup
|
|
|
|
### Option 1: Interactive CLI
|
|
|
|
```bash
|
|
opensre integrations setup
|
|
```
|
|
|
|
Select **Jira** when prompted and provide your base URL, email, API token, and project key.
|
|
|
|
### Option 2: Persistent store
|
|
|
|
Add to `~/.opensre/integrations.json`:
|
|
|
|
```json
|
|
{
|
|
"version": 1,
|
|
"integrations": [
|
|
{
|
|
"id": "jira-prod",
|
|
"service": "jira",
|
|
"status": "active",
|
|
"credentials": {
|
|
"base_url": "https://your-org.atlassian.net",
|
|
"email": "you@example.com",
|
|
"api_token": "your-api-token",
|
|
"project_key": "OPS"
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
| Field | Description |
|
|
| --- | --- |
|
|
| `base_url` | **Required.** Your Jira instance URL (e.g., `https://your-org.atlassian.net`) |
|
|
| `email` | **Required.** Email address associated with the API token |
|
|
| `api_token` | **Required.** Jira API token |
|
|
| `project_key` | **Required.** Default project key for new issues (e.g., `OPS`, `SRE`) |
|
|
|
|
## Creating a Jira API token
|
|
|
|
1. Go to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
|
|
2. Click **Create API token**
|
|
3. Give it a label (e.g., `opensre`)
|
|
4. Copy the token
|
|
|
|
<Info>
|
|
For Jira Data Center/Server, use a personal access token from **Profile** → **Personal Access Tokens** instead.
|
|
</Info>
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
opensre integrations verify jira
|
|
```
|
|
|
|
Expected output on success:
|
|
|
|
```
|
|
Service: jira
|
|
Status: passed
|
|
Detail: Configured for Jira at https://your-org.atlassian.net.
|
|
```
|
|
|
|
This is a configuration-presence check (`base_url`, `email`, and `api_token` are all set) rather than a live API call.
|
|
|
|
## Troubleshooting
|
|
|
|
| Symptom | Fix |
|
|
| --- | --- |
|
|
| **401 Unauthorized** | Check email and API token combination |
|
|
| **404 Not Found** | Verify `base_url` (include `https://`) and `project_key` |
|
|
| **403 Forbidden** | The user may lack permission to create issues in the project |
|
|
|
|
## Security best practices
|
|
|
|
- Use a **dedicated Jira user** for OpenSRE with only the permissions it needs (create and comment on issues).
|
|
- Store credentials in `~/.opensre/integrations.json`, not in source code or environment variables.
|
|
- Rotate the API token periodically.
|