연동: Jira, Azure DevOps, GitHub Issues, Slack, Teams 및 Telegram
Nexus StudioQA는 Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams 및 Telegram의 여섯 가지 서비스에 연결됩니다. 각 연동은 사용자가 켜기 전까지 꺼져 있으며, 당사 서버를 거치지 않고 사용자 컴퓨터에서 직접 연결됩니다. 이 페이지에서는 각 연동의 기능, 읽어 들이는 키, 수행하지 않는 작업을 설명합니다.
최종 업데이트:
작성: Nexus StudioQA 팀, Verdict System LLC. 2026년 10월 9일.
모든 연동의 작동 방식
- 직접 켜기 전까지는 꺼져 있습니다. 각 서비스에는 별도의 스위치가 있습니다:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLED및TELEGRAM_ENABLED. 모두 기본값은false입니다. - 사용자 컴퓨터에서 직접 연결합니다. 엔진은 테스트를 실행하는 컴퓨터에서 각 서비스의 API를 직접 호출합니다. 당사 서버를 거치는 데이터는 없으며, 당사는 사용자의 이슈, 알림, 결과를 볼 수 없습니다.
- 키는 작업 공간에 보관됩니다. 토큰과 키는 사용자 디스크에 있는 작업 공간의
.env파일에 한 줄씩 저장됩니다. 설정의 연동 항목에서 이를 편집할 수 있으며, 모든 토큰, 키, 웹훅은 가려진 상태로 표시됩니다. - 샌드박스 실행은 제외됩니다. 샌드박스 실행은 아직 작성 중인 테스트이지 발견된 문제가 아니므로, 이슈를 생성하거나 이슈에 댓글을 달거나 이슈를 종료하지 않습니다.
테스트가 계속 실패하는 동안 이슈는 테스트당 하나만 유지됩니다
Jira, Azure Boards, GitHub Issues는 동일한 수명 주기를 따르며, 티켓 설정에서 각 단계를 변경할 수 있습니다. 이슈는 실행이 아니라 테스트에 연결되므로, 매일 밤 실패하는 테스트는 매번 새 이슈를 만드는 대신 하나의 이슈에 이력을 쌓습니다.
- 첫 실패 시 이슈 하나를 생성합니다. 실행이 BREACHED, BREACHED_FLAKY, CHAOS_BREACHED 또는 TIMEOUT으로 끝나면 해당 테스트에 대해 이슈 하나를 생성하고, 오류와 실패 시점의 스크린샷을 첨부합니다.
- 반복해서 실패하면 기존 이슈에 댓글을 추가합니다. 해당 이슈가 열려 있는 동안 다시 실패하면 새 스크린샷을 첨부한 댓글을 추가합니다. 두 브라우저에서 동시에 실패해도 같은 이슈에 추가합니다.
- 문제없이 통과하면 이슈를 종료합니다. 한 실행의 모든 브라우저에서 테스트가 문제없이 통과하면, 이슈에 이를 알리는 댓글을 추가하고 완료 상태로 전환합니다. 워크플로에 해당 전환이나 상태가 없으면 댓글만 추가합니다.
- 그 이후에 실패하면 새 이슈를 생성합니다. 기존 이슈가 삭제되었거나 이동된 상태에서 실패한 경우에도 새 이슈를 생성합니다.
첨부 파일: 기본적으로 스크린샷만 첨부합니다. Playwright 추적 파일과 실행 로그에는 쿠키, 인증 헤더, 입력한 비밀번호 등의 세션 데이터가 포함될 수 있으므로, 설정에서 NEXUS_ISSUE_ATTACH_TRACE=true로 명시적으로 허용한 경우에만 함께 첨부합니다. 파일당 최대 10 MB까지 첨부할 수 있습니다.
FLAKY는 이슈를 생성하지 않습니다: 실패 후 재시도에서 통과한 실행은 버그가 아닙니다. BLOCKED, UNREACHABLE, CRASHED 또는 구성 오류 역시 애플리케이션이 아닌 환경에 관한 문제이므로 이슈를 생성하지 않습니다 (판정 결정 방식). 각 테스트에 연결된 이슈 정보는 작업 공간의 evidence/integrations/issue-map.json에 보관됩니다.
단계별 안내
각 안내에서는 필요한 사항, 인증 정보 발급 방법, 정상 작동 확인 방법을 설명하고, 자주 발생하는 오류와 그 원인 및 해결 방법을 제공합니다.
실패 알림을 보낼 수 있는 더 많은 곳
추가로 제공되는 다섯 곳의 전송 대상에도 위 서비스와 동일한 규칙이 적용됩니다. 모두 직접 켜기 전까지는 비활성화되어 있으며, 사용자의 컴퓨터에서 사용자의 키로 직접 연결됩니다.
- Linear: 선택한 팀에 실패한 테스트마다 이슈를 하나씩 생성합니다. 실패가 반복되면 댓글을 추가하고, 정상 통과하면 첫 번째 완료 상태로 이동합니다. 키:
LINEAR_ENABLED,LINEAR_API_KEY,LINEAR_TEAM_ID. - GitLab Issues: GitLab 프로젝트에서 동일한 수명 주기로 관리됩니다. 정상 통과하면 이슈를 닫고, 실패가 재발하면 다시 엽니다. 키:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKEN,GITLAB_ISSUES_PROJECT. 토큰은 https로만 전송됩니다. - PagerDuty: 실패하면 인시던트를 생성하고, 실패가 반복되면 같은 인시던트에 내용을 추가하며, 정상 통과하면 해결 처리합니다. 키:
PAGERDUTY_ENABLED,PAGERDUTY_ROUTING_KEY. - Opsgenie: 알림 형태로 동일한 수명 주기를 따르며, 정상 통과하면 알림을 닫습니다. 키:
OPSGENIE_ENABLED,OPSGENIE_API_KEY. - TestRail: 테스트의
// nexus:testrail C123주석에 지정된 케이스에 각 실행 결과를 보고합니다. 키:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEY,TESTRAIL_PROJECT_ID.
근본 원인별로 그룹화는 티켓 설정의 규칙으로, 기본적으로 꺼져 있습니다. 이 규칙을 켜면 이미 열린 이슈가 있는 테스트와 동일한 오류로 실패한 경우 새 이슈를 만드는 대신 기존 이슈에 댓글을 추가합니다. 그룹화된 테스트가 정상 통과하더라도 원래 테스트의 이슈는 닫히지 않습니다.
AI 도우미에게 안내 요청하기
어떤 AI 도우미든 이 안내에 따라 도와줄 수 있습니다. 안내 페이지 주소나 integrations-guide.json의 주소를 알려 주세요. 이 파일에는 모든 키, 각 키의 유효한 형식과 확인 방법, 각 오류의 원인 및 해결 방법이 나와 있습니다.
- 채팅에 토큰, 키, 비밀번호 또는 웹훅 URL을 절대 붙여넣지 마세요. 인증 정보는 Studio의 설정, 연동에서만 입력하세요. 도우미에게는 인증 정보가 전혀 필요하지 않습니다.
- 비밀이 아닌 정보만 알려 주세요: 사이트 주소, 프로젝트 이름, Studio에 표시되는 정확한 오류 문구입니다.
- 정상 작동 여부는 Studio 자체 점검으로 확인하세요. 연결이 작동하는지 알려 주는 것은 도우미가 아니라 연결 확인, 테스트 메시지 보내기, 테스트 티켓 만들기 기능입니다.
- 이미 채팅에 인증 정보를 붙여넣었다면, 해당 서비스에서 폐기하고 새로 발급하세요.
Jira Cloud
- 연결: Atlassian 계정 이메일과 id.atlassian.com에서 생성한 API 토큰을 사용합니다. 설정의 연동 항목에 Jira 사이트의 링크를 아무거나 붙여 넣으면 Studio가 사이트와 프로젝트 키를 저장합니다. 사이트 주소인
JIRA_BASE_URL은 https여야 합니다. 연결 확인은 연결 정보를 테스트할 뿐, 아무것도 생성하지 않습니다. - 이슈:
JIRA_PROJECT_KEY에 위 수명 주기를 따르는 Bug를 생성합니다. 문제없이 통과하면 이슈는JIRA_DONE_TRANSITION에 지정된 이름의 전환을 통해 이동합니다. 기본값은 Done이며, 이름은 대소문자를 구분하지 않고 일치 여부를 확인합니다. - 중복 방지: 지난 24시간 이내에 동일한 요약의 Bug가 생성되었다면 새로 생성하지 않습니다.
- 여러 Jira 사이트: 티켓에서 다른 Jira 사이트 추가를 선택하면 별도의 사이트, 프로젝트 키, 이슈 유형을 가진 전송 대상이 추가됩니다. 활성화된 전송 대상마다 별도의 티켓이 생성됩니다. 사이트는 https://<name>.atlassian.net 형식의 Atlassian Cloud 주소여야 하며, Atlassian 이메일 하나와 API 토큰 하나로 해당 계정의 모든 사이트를 이용할 수 있습니다. 토큰은 나열한 사이트에만 전송됩니다.
- 수동 전송: 원할 때 Evidence Locker에서 실패 내용을 Jira로 보낼 수 있습니다.
Azure DevOps: Boards, Test Plans 및 Pipelines
개인용 액세스 토큰(PAT) 하나와 프로젝트 하나를 사용하며, AZURE_DEVOPS_ORG_URL(https://dev.azure.com/<org> 또는 https://<org>.visualstudio.com)과 AZURE_DEVOPS_PROJECT에 설정합니다. PAT는 Azure DevOps 자체 호스트에만 전송되며 로그에는 절대 표시되지 않습니다. 설정의 통합에서 Azure DevOps 연결을 선택하면 프로젝트와 작업 항목 유형을 확인하며, 아무것도 생성하지 않습니다.
- Azure Boards:
AZURE_BOARDS_ENABLED=true이면 실패 시 위의 수명 주기에 따라AZURE_BOARDS_WORK_ITEM_TYPE유형의 작업 항목이 생성되며, 기본값은 Bug입니다. 문제없이 통과하면AZURE_BOARDS_DONE_STATE에 지정된 상태로 전환되며, 기본값은 Resolved입니다; 프로세스에서 해당 상태를 허용하지 않으면 댓글만 추가됩니다. PAT에는 Work Items(읽기 & 쓰기) 권한이 필요합니다. Evidence Locker에서도 실패를 Azure Boards로 수동 전송할 수 있습니다. - Azure Test Plans: CI/CD 화면에서 생성하는
azure-pipelines.yml은PublishTestResults@2작업을 통해 실행의 JUnit XML을 게시하므로, 모든 파이프라인 실행이 Test Plans의 Runs에 표시됩니다. - Azure Pipelines:
nexus ci-remote --provider=azure는AZURE_PIPELINE_ID에 지정된 파이프라인 실행을 대기열에 추가하고, 완료될 때까지 기다린 후 JUnit XML을 이 컴퓨터로 가져옵니다. 이를 위해 PAT에는 Build(읽기 & 실행) 권한이 필요합니다.
GitHub Issues
- 연결: 저장소 하나에 대한 Issues (읽기 및 쓰기) 권한이 있는 세분화된 개인 액세스 토큰을
GITHUB_ISSUES_TOKEN에, owner/repo 형식의 저장소를GITHUB_ISSUES_REPO에 지정합니다. 설정의 연동에서 GitHub Issues 연결을 선택하면 토큰 소유자가 표시되며, 해당 토큰으로 접근할 수 있고 Issues가 활성화된 저장소만 제공됩니다 (단계별 안내). - 이슈:
GITHUB_ISSUES_ENABLED=true이면 실패 시 티켓의 레이블이 적용된 이슈가 생성되며, 위의 수명 주기를 따릅니다. 문제없이 통과하면 이슈에 댓글이 추가되고 완료 상태로 닫힙니다. - 다른 저장소: 티켓에서 GitHub 전송 대상에
.env에 지정된 것과 다른 owner/repo를 지정할 수 있습니다.
Slack
- 연결:
SLACK_WEBHOOK_URL에 수신 웹후크 URL 하나를 설정합니다. 설정에 테스트 메시지 보내기 버튼이 있습니다. - 수신 항목: Block Kit 메시지로 실행 요약을 받으며,
NEXUS_SLACK_NOTIFY=true이면 실패한 테스트, 결과가 불안정한 테스트, 카오스 테스트 또는 시각적 회귀 테스트마다 메시지를 하나씩 받습니다. 실패 메시지에는 관련 Jira 이슈가 있는 경우 해당 링크가 포함됩니다. - 수동 전송: Evidence Locker에서 실패의 텍스트 요약을 Slack에 게시할 수 있습니다. Slack에는 파일이 전송되지 않습니다.
Microsoft Teams
- 연결: 채널의 Workflows 웹후크 URL 하나를
TEAMS_WEBHOOK_URL에 지정합니다. Teams Workflows에는 Microsoft 365 회사 또는 학교 계정이 필요합니다. 설정에 저장 & 테스트 전송이 있습니다 (단계별 안내). - 수신 내용: Slack과 동일한 메시지를 Adaptive Cards 형식으로 받습니다: 실행 요약과,
NEXUS_TEAMS_NOTIFY=true인 경우 실패, 불안정, 카오스 또는 시각적 회귀 테스트마다 메시지 하나를 받습니다. - URL 전송 대상: Microsoft 자체 웹후크 호스트(logic.azure.com, webhook.office.com, api.powerplatform.com)의 https 주소로만 전송됩니다. 다른 URL은 모두 거부되며 아무것도 전송되지 않습니다.
Telegram
- 연결: @BotFather로 한 번 생성한 나만의 봇을
TELEGRAM_TOKEN에 설정합니다. 설정에서 QR로 연결을 선택하면 채팅이 연결되고TELEGRAM_CHAT_ID가 채워집니다. 공유 봇은 없습니다. - 수신 항목: 실패 알림을 받으며,
NEXUS_TELEGRAM_NOTIFY=true이면 테스트마다 하나씩 받습니다. 또한 Studio에서 공유하기로 선택한 보고서와 파일을 받습니다. - 활성화하기 전에: Telegram은 보고서와 PDF 등의 파일을 수신할 수 있으며, 이 파일은 Telegram 서버로 전송됩니다. 규제가 적용되는 환경에서는 먼저 규정 준수 담당 팀에 문의하세요.
티켓: 생성 시점, 포함 내용, 전송 대상
설정의 연동 아래에 있는 티켓 화면에서 테스트 실패 시 Jira, Azure Boards 또는 GitHub Issues에 등록할 내용을 설정합니다. Evidence Locker의 공유 기능도 같은 템플릿을 사용합니다. 설정은 작업 공간의 nexus-tickets.config.json에 저장되며, 이 파일에는 비밀 정보가 없어 저장소에 보관해도 됩니다. 파일이 없으면 위에서 설명한 방식으로 티켓이 처리됩니다. 파일이 유효하지 않으면 기본값이 적용되고 그 이유가 로그에 기록됩니다.
- 생성 조건: 티켓을 생성할 판정(기본값은 BREACHED 및 TIMEOUT), 생성 전 연속 실패 횟수, 실행당 생성 한도, 로컬 실행과 CI 실행 중 적용 대상, 포함하거나 제외할 테스트 ID, 정상 통과 시 처리 방식(닫기, 댓글만 추가 또는 아무 작업 안 함), 같은 실패가 재발하면 새 티켓을 만드는 대신 닫힌 티켓을 다시 열지 여부를 설정합니다.
- 내용:
{type},{testId},{browser},{error.firstLine}을 사용하는 제목 템플릿을 설정합니다. 제목은 24시간 동안 중복을 판별하는 키이므로{testId}는 필수입니다. 전송할 설명 항목과 순서, 오류 내용의 포함 범위, 라벨, 판정별 우선순위, 담당자, 구성 요소, 사용자 지정 필드, 팀 메모도 설정합니다. - 첨부 파일: 기본적으로 스크린샷이 첨부됩니다. 추적 기록, 동영상, 보고서는 선택한 경우에만 첨부되며, 각각 용량 제한이 적용됩니다.
- 대상: 추적 도구마다 하나의 전송 대상을 설정하며, 각 대상은 개별적으로 켜거나 끌 수 있습니다. 대상별로 Jira 사이트, 프로젝트 및 이슈 유형, GitHub 저장소 또는 Azure 작업 항목 유형을 재정의할 수 있습니다.
- 미리 보기 및 테스트: 저장하기 전에 가장 최근 실패를 바탕으로 생성될 티켓을 대상별로 화면에 표시합니다. 테스트 티켓 만들기를 누르면 이 내용을 바탕으로
nexus-test라벨이 붙은 실제 티켓 하나가 등록됩니다.
티켓에 절대 포함되지 않는 정보
- 선택한 항목만 전송합니다. 선택하지 않은 항목이나 첨부 파일은 내 컴퓨터에 그대로 남습니다.
- 비밀 정보는 먼저 가립니다. 모든 텍스트 줄은 등록 전에 민감 정보 삭제 단계를 거칩니다. 인증 및 쿠키 헤더, bearer 및 basic 토큰, JWT, 알려진 제공업체 키 형식, URL 안의 비밀번호, 비밀 정보를 나타내는 이름을 가진 필드의 값이 대상입니다. 로그와 오류에서 흔히 나타나는 비밀 정보 형식을 감지하지만 자유 형식 텍스트에 담길 수 있는 모든 비밀 정보를 찾아내지는 못하므로, 필요하지 않으면 추적 기록 첨부는 꺼 두세요.
- 파일에는 토큰이 들어가지 않습니다.
nexus-tickets.config.json은 비밀 정보를 나타내는 이름을 가진 필드와 사용자 이름 및 비밀번호가 포함된 URL을 허용하지 않습니다. 토큰은.env에 보관됩니다.
키
각 키는 작업 공간의 .env에 한 줄씩 저장됩니다. 모두 설정에서 편집할 수 있습니다.
| 서비스 | 키 | 기본값 |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | 꺼짐; 프로젝트 QA; 전환 상태 Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | 꺼짐; 유형 버그; 상태 해결됨 |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | 꺼짐 |
| 이슈 첨부 파일 | NEXUS_ISSUE_ATTACH_TRACE | 꺼짐: 스크린샷만 |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | 꺼짐 |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | 꺼짐 |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | 꺼짐 |
파이프라인에서는 AZURE_PIPELINE_ID를 제외한 동일한 키를 파이프라인의 비밀 변수로 사용하며, 키를 설정하지 않으면 해당 서비스는 꺼진 상태로 유지됩니다 (CI/CD의 비밀 정보).
질문
Nexus StudioQA에서 제 Jira 또는 Azure DevOps 데이터를 볼 수 있나요?
아니요. 엔진은 사용자 컴퓨터에서 사용자의 키로 Jira, Azure DevOps, GitHub Issues, Slack, Teams 및 Telegram과 통신합니다. 어떤 데이터도 당사 서버를 거치지 않습니다.
불안정한 테스트도 티켓을 생성하나요?
아니요. FLAKY는 아무것도 등록하지 않습니다. BREACHED_FLAKY는 등록합니다: 실패 자체가 일관되지 않았으며, 재시도해도 이 실패가 숨겨지지 않습니다.
이번 주에 테스트가 30번 실패했습니다. 이슈는 몇 개 생성되나요?
하나입니다. 모든 브라우저에서 테스트가 문제없이 통과할 때까지, 첫 실패 이후 실패할 때마다 댓글과 새 스크린샷이 추가됩니다.
Jira, Azure Boards, GitHub Issues를 동시에 사용할 수 있나요?
네. 각 도구는 테스트마다 자체 이슈를 따로 유지하며, 추가한 각 Jira 사이트도 마찬가지입니다.