Jira

備考

プレビュー

Lakewatchは プライベート プレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームにお問い合わせください。

Lakewatch アラートをJiraに課題としてエクスポートします。アラートが作成されると、LakewatchはJira課題を作成し、アラートの変更に応じてそれを更新します。送信先全体のエクスポートの動作については、アラート通知先を参照してください。

LakewatchからJiraへのエクスポートは一方向です。Lakewatchは、ユーザーのEメールとAPIトークンを基本認証資格情報として使用して、Jira クラウドに対して認証を行います。

前提条件

Jiraを設定する

• ターゲットプロジェクトで課題を作成および更新できるJiraアカウント。
• そのアカウントのAPIトークン。Jira クラウドの基本認証の認証情報として、アカウントのEメールアドレスとペアになっています。Atlassianアカウント設定でAPIトークンを作成します。

APIトークンをUnity Catalogシークレットとして保存する

Lakewatchは、アラートをエクスポートするたびに、catalog.schema.secret形式の3レベル名を持つセキュリティ保護可能なUnity CatalogシークレットからJira APIトークンを読み取ります。Lakewatchはシークレットの値ではなくシークレットの名前のみを保存します。

このシークレットを事前に作成することも、Jiraエクスポートを設定するときに シークレットの作成 ボタンを使用してインラインで作成することもできます。どちらの方法でも、シークレットを作成するにはカタログに対する USE CATALOG が必要であり、スキーマの所有権、またはスキーマに対する CREATE SECRET と USE SCHEMA の両方が必要です。ステップについては、「シークレットの作成」を参照してください。

必要な権限

Jiraエクスポートを構成するには、以下が必要です：

• READ SECRET APIトークンを保持するUnity Catalogシークレット、またはその親スキーマまたはカタログ。Lakewatchは、構成を保存する際にシークレットを読み取れることを確認します。それを付与するには、「シークレットの権限を管理する」を参照してください。
• ワークスペース設定でアラートのエクスポート構成を編集する権限。

エクスポート時、Lakewatch はその Service Principal として API トークン自体を読み取ります。Lakewatch はエクスポートのたびに名前でシークレットを読み取るため、シークレットのローテーションはタッチ不要です。 Unity Catalog のシークレットを更新するだけで、 Lakewatch は次のエクスポート時に新しい値を使用し、エクスポート構成に変更はありません。

Jiraエクスポートの構成

アラート 設定セクションで、アラートのJira送信先を構成します。

1. Lakewatchサイドバーで、 設定 に移動し、 アラート を開きます。
2. アラート の下で エクスポート 設定を見つけます。
3. エクスポート送信先を Jira に設定します。
4. ワークスペース では、送信先がPrivateLink Endpointやリージョン制限されたサービスなど、特定のワークスペースのネットワークの背後にある場合を除き、現在のワークスペースをそのまま使用してください。このワークスペースのネットワーク経由でエクスポートが配信されます。
5. Instance URL に、課題が登録されるJiraインスタンスを入力します（例：https://acme.atlassian.net）。
6. プロジェクトキー に、課題が作成されるプロジェクトを入力します。
7. 「 ユーザーのEメール 」に、APIトークンとペアになっているアカウントのEメールアドレスを入力します。
8. APIトークン を、Jira APIトークンを保持するUnity Catalogシークレットに設定します。3レベルの名前 (catalog.schema.secret) を入力または貼り付け、 [シークレットの選択] をクリックして既存のシークレットを選択するか、 [シークレットの作成] をクリックしてページを離れることなくAPIトークンから新しいシークレットを作成します。保存後、シークレットフィールドは読み取り専用になります。更新するには、Unity Catalogでシークレットをローテーションします。
9. defaultの課題タイプ で、必要に応じて作成する課題タイプ（例：Task）を設定します。
10. 変更を保存します。

すべてのアラート設定のリファレンスについては、「 設定の構成」を参照してください。

トラブルシューティング

• Jiraで課題が作成されない： インスタンスURLまたはプロジェクトキーが間違っているか、アカウントがプロジェクトで課題を作成できません。インスタンスURL、プロジェクトキー、およびアカウントとAPIトークンがプロジェクトで課題を作成できることを確認します。
• 構成が保存されていません ：Unity Catalogのシークレットを読み取る権限がないか、シークレット名がcatalog.schema.secretの形式ではありません。シークレットおよびシークレット名へのアクセス権を確認してください。
• 認証失敗 : ユーザーEメールまたはAPIトークンが正しくありません。Eメールがトークンとペアになっているアカウントであることを確認し、シークレットに保存されているトークンが有効であることを確認してください。
• APIトークンをローテーションしました ：Unity Catalogシークレットを新しい値で更新します。エクスポート構成の変更は不要です。