Ansible で Atlassian Automation を使用する

はじめる前に

プロジェクトの自動化を管理するには、次のような適切なプロジェクト権限が必要です。

• 企業管理対象プロジェクト: プロジェクトを管理とプロジェクトを参照の各権限がプロジェクトに必要です。企業管理対象プロジェクトの権限に関する詳細についてご確認ください。

• チーム管理対象プロジェクト: プロジェクトの管理者アクセス権が必要です。チーム管理対象プロジェクトの権限に関する詳細についてご確認ください。

グローバル自動化を管理するには、Jira 管理権限が必要です。Jira Cloud のグローバル権限に関する詳細についてご確認ください。

Ansible では、接続が正しく機能するように、次の設定が行われていることを確認してください。

• Ansible の Automation コントローラーで HTTPS ポートを開く。Ansible のネットワーク ポートとプロトコルの詳細

• Ansible での Automation の X-オリジン リクエストを有効にする。Ansible で X-original リクエストを有効にする方法をご覧ください
  CORS_ORIGIN_ALLOW_ALL = True を作成して、使用している Jira サイトの URL を CORS_ALLOWED_ORIGIN_REGEXES = [
  r"<https://<your_jira_site>>.atlassian.net*",
  ] などの許可された正規表現に追加する必要があります。

• ファイアウォールを使用している場合は、Ansible の Automation コントローラーへのアクセスを確保するために、アトラシアン IP アドレス [IP address] を許可してください。 アトラシアン IP アドレスとドメインの詳細

自動化ルールを Ansible と統合する

1. Ansible の既存のアプリを使用して Atlassian Automation に接続できます。アプリがない場合は、新規に作成してください。 作成を開始するには、Ansible でアプリを作成する方法を読んでください。作成時には、以下の詳細を使用してください。
   リダイレクト URI: https://id.atlassian.com/outboundAuth/finish
   Client Type (クライアント タイプ): Confidential (機密情報)
   Authorisation Grant Type (認証付与タイプ): Authorisation Code (認証コード)

2. Jira Service Management で、Automation に移動して [ルールを作成] を選択します。

3. ルールに適用する Ansible アクションを選択します。現時点で利用できるアクションは、Ansible でジョブ テンプレートを起動のみです。

4. [接続] を選択して、Ansible との接続を作成します。接続すると、自動化ルールによって他のツールや製品で変更を加えられるようになります。

5. 使用する接続で、Atlassian Automation に接続したいアプリ情報を入力します。

   1. アプリケーション名。Ansible 接続を簡単に識別できるように、一意の名前を付けてください。これはアプリケーションの名前である必要はありませんが、一意の識別子を付けてアプリケーション名を指定すると便利です。たとえば、Acme A や Acme B とします。ここで Acme はアプリケーション名、A と B は固有の値です。

   2. クライアント ID。Ansible のアプリケーションのクライアント ID です。アプリケーションを作成した後に一度だけ表示されます。

   3. クライアント シークレット。Ansible のアプリケーションのクライアント シークレットです。アプリケーションを作成した後に一度だけ表示されます。

   4. Ansible Tower URL。これは通常、Ansible の Automation コントローラーを開いているときにブラウザのアドレス バーに表示される URL です。

6. [接続] を選択して接続の作成を完了します。