Jira Cloudに接続する: 手順別ガイド
失敗したテストごとにBugを1件登録し、同じテストが再び失敗するとコメントを追加します。テストが問題なく成功すると、Doneに移行します。このガイドでは、準備から接続確認までの手順を説明し、発生しうるエラーとその原因、対処方法を紹介します。
最終更新日:
認証情報は非公開にしてください。 トークン、キー、パスワード、Webhook URL をチャットに貼り付けないでください。入力先は Studio → 設定 → 連携のみにしてください。認証情報はワークスペースの .env ファイルに保存され、画面上では点で表示されます。AI アシスタントにも同じことが当てはまります。このガイドに沿って手順を案内することはできますが、トークンを伝える必要はありません。
必要なもの
- Jira Cloudサイト。例: https://your-team.atlassian.net (Jira Cloudのみ対応; アドレスはhttpsで始まる必要があります)。
- Atlassianアカウントのメールアドレスと、同じアカウントで作成したAPIトークン。
- Bugという名前の課題タイプがあるプロジェクトのキー。例: QA。
- そのプロジェクトで、対象のアカウントに課題の閲覧、作成、コメントの追加、添付ファイルの作成、課題のステータス変更の権限があること。
認証情報を取得する
- https://id.atlassian.com/manage-profile/security/api-tokens を開き、「APIトークンを作成」を選択します。
- 名前 (例: "Nexus StudioQA") と有効期限を設定して作成し、その場でトークンをコピーします。Atlassianでトークンが表示されるのは一度だけです。
- クリップボードに保持してください。Studio (次の手順) 以外には貼り付けないでください。
Studio で接続する
- Studioで「設定」 → 「連携」 → 「Jiraに接続」を開きます。
- Jiraの任意のリンク (ホームページ、ボード、課題など) を貼り付け、「接続を確認」を押します。Studioがサイトのアドレスとプロジェクトキーを保持します。
- 入力を求められたら、Atlassianのメールアドレスとトークンを入力し、「保存 & 確認」を押します。
- "バグの登録先"でプロジェクトを選択し、
JIRA_ENABLEDを有効にします。
動作を確認する
- 「接続を確認」で"<your name>としてサインインしました"と"<KEY>はBugチケットを受け付けます"と表示されます。この確認は読み取りのみで、チケットを作成することはありません。
- 「設定」 → 「連携」 → 「チケット」を開き、「テストチケットを作成」を押します。nexus-testラベル付きのチケットが1件登録されます。この画面でJiraを呼び出す操作は、このボタンのクリックだけです。
- Jiraでそのチケットを開き、auto-generated、nexus-studioqa-automation、nexus-testのラベルが付いていることを確認します。確認が終わったら削除してください。
よくあるエラー
| 確認できる結果 | 原因 | 解決方法 |
|---|---|---|
| "これはリンクではありません"または"Jiraのリンクはhttps://で始まります" | 貼り付けたテキストが完全なウェブアドレスではないか、http://で始まっています。 | Jiraサイトを開いた状態で、アドレスバーの内容をコピーしてください。https://で始まる必要があります。 |
| HTTP 401 | メールアドレスまたはトークンが間違っている、トークンの有効期限が切れているか失効している、またはメールアドレスがトークンを作成したアカウントのものではありません。 | 保存したメールアドレスのアカウントでid.atlassian.comにアクセスして新しいトークンを作成し、「設定」で両方を再保存してください。 |
| HTTP 403 | サインインには成功していますが、Jiraでそのアカウントによる操作が許可されていません。通常は、プロジェクトで課題の作成、コメントの追加、添付ファイルの作成のいずれかの権限が不足しています。 | プロジェクト管理者にこれらの権限の付与を依頼するか、別のプロジェクトを選択してください。Nexus StudioQAから権限を付与することはできません。 |
| HTTP 404 | サイトのアドレスまたはプロジェクトキーが存在しないか、そのアカウントではプロジェクトを表示できません (Jiraは非表示のプロジェクトに対して404を返します)。 | 正しいサイトのリンクを貼り付け、一覧からプロジェクトを選択してください。 |
| "そのアドレスから応答がありましたが、Jiraアカウントの応答ではありませんでした" | そのアドレスはJira Cloudサイトではありません (ServerやData Centerのアドレス、または別のウェブページなど)。 | Jira Cloudサイトの https://<team>.atlassian.net アドレスを使用してください。 |
| "<KEY>にはBugという名前の課題タイプがありません" | プロジェクトにBugという課題タイプがないため、チケットを作成できません。 | Jiraでプロジェクト設定 → 課題タイプを開いてBugを追加するか、別のプロジェクトを選択してください。 |
| "Jiraに接続できませんでした (ENOTFOUND)" または "20秒以内に応答がありませんでした" | このPCからサイトに接続できません: アドレスの入力ミス、VPNやプロキシの影響、またはネットワーク未接続が考えられます。 | アドレスを修正し、同じPCのブラウザーでサイトを開いてください。その後、確認を再試行してください。 |
| 確認では問題がないのに、チケットが表示されない | JIRA_ENABLEDがfalseになっている、判定がFLAKYまたは環境に関する判定だった、サンドボックスでの実行だった、そのテストに未解決のBugがすでに存在する (再度失敗した場合は代わりにコメントを追加します)、または同じタイトルのBugが過去24時間以内に作成されています。 | JIRA_ENABLEDを有効にし、連携ページの"テストごとに1つの課題"を読んで、テストチケットを作成で接続を確認してください。 |
| テストに合格してもチケットが閉じられない | ワークフローにJIRA_DONE_TRANSITIONと同じ名前のトランジションがないため、チケットにはコメントのみが追加されます。 | JIRA_DONE_TRANSITIONに、ワークフローのトランジションボタンの正確な名前を設定してください。 |
設定キー
| キー | 主な機能 | 有効な値 | 確認方法 |
|---|---|---|---|
JIRA_ENABLED | 失敗時にJiraチケットを作成 | true または false | 連携を有効にしてから、テストチケットを作成を実行してください。 |
JIRA_BASE_URL | Jiraサイトのアドレス | https://<site>.atlassian.net | 接続を確認するとサイトが表示されます。リンクを貼り付けると自動入力されます。 |
JIRA_EMAIL | Jiraへのサインイン用メールアドレス | トークンを所有するAtlassianアカウントのメールアドレス | 接続を確認すると、このメールアドレスとともに"…としてサインイン中"と表示されます。 |
JIRA_API_TOKEN | Jiraアクセストークン (秘密情報、このコンピューターにのみ保存) | 1 行で入力、引用符や空白なし | 接続の確認: HTTP 401はメールアドレスとトークンの組み合わせが間違っていることを示します。 |
JIRA_PROJECT_KEY | Bugチケット用のJiraプロジェクト | プロジェクトキー。通常は大文字で、例としてQAなど | プロジェクトの選択一覧に表示されます。"Bugチケットを作成可能"とあれば、課題タイプに対応しています。 |
JIRA_DONE_TRANSITION | テスト合格時のJiraのステータス | ワークフローのトランジションの正確な名前。大文字と小文字は区別されません | 問題なく合格するとチケットが遷移します。ワークフローに該当するトランジションがない場合は、コメントのみが追加されます。 |
詳細: すべての連携, 設定ガイド, 問題の解決方法. その他のガイド: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
まだ解決しませんか? Studioに表示されるエラー行をそのまま添えて、[email protected]までご連絡ください。トークンは記載しないでください。