jira ticket classification

Jira 티켓 분류

개요

Jira 티켓 분류는 Amazon Bedrock의 AI 기능을 사용하여 Jira 티켓을 분류하도록 설계된 자동화 시스템입니다. 이 프로젝트는 Jira Server 내보내기와 함께 사용할 수 있으며 Jira Cloud에서 사용할 수 있는 것과 유사한 자동화 기능을 제공합니다.

아키텍처 다이어그램

특징

• 콘텐츠에 따라 Jira 티켓을 자동으로 분류합니다.
• AI 기반 분류를 위해 Amazon Bedrock을 활용합니다.
• S3에 배치된 Jira 티켓 내보내기를 처리합니다.
• 데이터 중복 제거를 위해 AWS Glue 사용
• Jira Server 내보내기와 작동하도록 설계됨

참고 : 사용자가 Jira 내보내기를 수동으로 업로드하고 자동 가져오기를 실행할 수 있도록 허용하는 경우 중복 제거가 중요합니다. 증분 가져오기에 중복 항목이 포함되지 않도록 할 수 있으면 AWS Glue 작업을 제거할 수 있습니다.

작동 방식

1. 데이터 입력 : Jira 티켓 내보내기는 배포된 S3 버킷의 /unprocessed 폴더에 배치됩니다.

2. 데이터 처리 : 내보낸 티켓을 시스템에서 처리합니다.

3. Bedrock 분류 : 티켓 데이터는 Amazon Bedrock으로 전송되며, Amazon Bedrock은 미리 정의된 분류 프롬프트를 사용하여 각 티켓을 분류합니다.

4. 중복 제거 : AWS Glue는 중복 분류가 처리되지 않도록 보장하여 데이터 무결성을 유지합니다.

5. 결과 : 분류 결과는 저장되며 원본 Jira 티켓을 업데이트하거나 추가 분석을 위해 사용될 수 있습니다.

구성요소

• Lambda 함수 : 티켓 처리 및 분류를 위한 주요 로직을 처리합니다.
• Amazon Bedrock : 티켓 분류를 위한 AI 모델을 제공합니다.
• AWS Glue : 데이터 중복 제거를 관리합니다.
• S3 : Jira 내보내기 및 분류 결과를 저장합니다.
• Secrets Manager : Jira 티켓을 가져오기 위한 Jira API 키, 기본 URL 및 이메일 주소를 저장합니다.

설정 및 구성

중요 공지 : 이 프로젝트는 Terraform을 사용하여 AWS 환경에 리소스를 배포합니다. 사용된 AWS 리소스에 대한 비용이 발생합니다. 해당 AWS 지역의 Lambda, Bedrock, Glue 및 S3와 같은 서비스 가격을 알아두십시오.

필수 권한 : Terraform 스택을 배포하려면 높은 권한, 특히 고급 사용자 권한이 필요합니다.

프로젝트를 설정하려면:

1. 가져오려는 프로젝트 ID를 포함하도록 main.tf fetch_jira_issue_lambda의 환경 변수 PROJECT_IDS_COMMA_SEPARATED를 업데이트하세요.
2. 프로젝트의 infrastructure 폴더로 이동합니다.
3. terraform init 실행하여 Terraform 작업 디렉터리를 초기화합니다.
4. terraform apply 실행하여 AWS 환경에서 리소스를 생성합니다.
5. 비밀 관리자로 이동하여 Jira 구성으로 Jira 비밀을 업데이트하세요.

프로젝트를 해체하려면:

1. infrastructure 폴더로 이동합니다.
2. 이 프로젝트에서 생성된 모든 리소스를 제거하려면 terraform destroy 실행하세요.

보안

코드를 추가로 변경할 때마다 infrastruction 폴더에서 tfsec를 실행해야 합니다.

TFSec 실행

$ tfsec .

표시되지 않는 경고 코드를 추가로 변경할 때마다 infrastruction 폴더에서 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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

지원하다

지원을 받거나 문제를 보고하려면 프로젝트의 GitHub 저장소에서 문제를 열어주세요.