jira ticket classification

Jira 门票分类

概述

Jira Ticket Classification 是一个自动化系统，旨在使用 Amazon Bedrock 的 AI 功能对 Jira 票据进行分类。该项目可与 Jira Server 导出一起使用，提供与 Jira Cloud 中提供的自动化功能类似的自动化功能。

架构图

特征

• 根据 Jira 票证的内容自动对其进行分类
• 利用 Amazon Bedrock 进行人工智能驱动的分类
• 处理放置在 S3 中的 Jira 票据导出
• 使用 AWS Glue 进行重复数据删除
• 设计用于与 Jira Server 导出配合使用

注意：如果您允许用户手动上传 Jira 导出并运行自动拉取，则重复数据删除非常重要。如果您可以确保增量导入不包含重复项，则可以删除 AWS Glue 作业。

它是如何运作的

1. 数据输入：JIRA 票证导出放置在已部署的 S3 存储桶的/unprocessed文件夹中。

2. 数据处理：系统处理导出的票据。

3. Bedrock 分类：票证数据发送到 Amazon Bedrock，后者使用预定义的分类提示对每张票证进行分类。

4. 重复数据删除：AWS Glue 确保不处理重复的分类，从而保持数据完整性。

5. 结果：分类结果被存储，可用于更新原始 Jira 票证或用于进一步分析。

成分

• Lambda 函数：处理票证处理和分类的主要逻辑。
• Amazon Bedrock ：提供票证分类的 AI 模型。
• AWS Glue ：管理重复数据删除。
• S3 ：存储 Jira 导出和分类结果。
• Secrets Manager ：存储我们的 Jira API 密钥、基本 URL 和用于提取 Jira 票证的电子邮件地址。

设置和配置

重要通知：该项目使用 Terraform 在您的 AWS 环境中部署资源。您将因使用的 AWS 资源而产生费用。请注意您的 AWS 区域中 Lambda、Bedrock、Glue 和 S3 等服务的定价。

所需权限：您需要提升权限，特别是高级用户权限，才能部署 Terraform 堆栈。

设置项目：

1. 更新 main.tf fetch_jira_issue_lambda 的环境变量 PROJECT_IDS_COMMA_SEPARATED 以包含要拉取的 projectId
2. 导航到项目中的infrastructure文件夹。
3. 运行terraform init以初始化 Terraform 工作目录。
4. 运行terraform apply以在您的 AWS 环境中创建资源。
5. 转到机密管理器并使用您的 Jira 配置更新 Jira 机密

拆除该项目：

1. 导航到infrastructure文件夹。
2. 运行terraform destroy以删除该项目创建的所有资源。

安全

每当对代码进行其他更改时，请确保在基础结构文件夹上运行 tfsec。

运行 TFSec

$ tfsec .

禁止的警告每次对代码进行其他更改时，请确保在基础结构文件夹上运行 tfsec。这些安全警告已被抑制，但在将该解决方案投入生产之前请先检查这些警告。此外，此示例存储库使用 AWS 托管密钥。鼓励在生产环境中使用客户管理密钥 (CMK)。

1. Secrets Manager“aws-ssm-secret-use-customer-key”：此警告要求我们使用 KMS 密钥作为我们的密钥。
2. S3“aws-s3-enable-bucket-logging”：如果存储桶日志记录对您的用例有意义，则删除并打开
3. S3 存储桶加密“aws_s3_bucket_server_side_encryption_configuration”：我们正在使用 AWS 托管加密密钥
4. Lambda“aws-lambda-enable-tracing”：如果这对您的项目有意义，请打开跟踪。

用法

1. 从您的 Jira Server 实例导出票证。
2. 将导出的票证数据放置在 Terraform 脚本创建的 S3 存储桶的/unprocessed文件夹中。
3. 系统会自动处理该文件夹中的新文件。
4. 从 S3 中指定的输出位置检索分类结果。

要求

• 有权访问 Lambda、Bedrock、Glue 和 S3 的 AWS 账户
• Terraform 安装在您的本地计算机上
• 您的 AWS 账户中的高级用户权限
• 能够从 Jira Server 导出票证（不需要 Jira Server 实例）

贡献

欢迎为改进该项目做出贡献。请随时提交拉取请求或开放问题来讨论潜在的增强功能。

执照

该项目已获得 MIT 许可证的许可。有关详细信息，请参阅许可证文件。

支持

如需支持或报告问题，请在项目的 GitHub 存储库中打开问题。