DOCS
インテグレーションガイド / Oracle Developer Cloud Service - PagerDuty

Oracle Developer Cloud Service - PagerDuty

本記事は米国PagerDuty社のサイトで公開されているものを日本語訳したものです。原文はこちらです。

Oracle Developer Cloud Service(DevCS)はオープンソースの標準的なツールをベースにした完全なDevOpsツールチェーンです。Oracle Cloudプラットフォームの基礎サービスとして、DevCSはさまざまなOracleプラットフォームおよびインフラストラクチャ・サービスとの統合を提供しています。DevCSを使用すると、ソフトウェアチームは、リリースおよび開発スプリントの計画、問題およびタスクの追跡、gitを使用したソフトウェアの開発およびバージョン管理、バイナリ成果物の管理、および1つ以上のOracle Cloudインフラストラクチャを活用した継続的インテグレーション(CI)および継続的配備/またはプラットフォームサービスを実現できるようになります。

DevCSの詳細は、https://cloud.oracle.com/developer_service (訳注:いまのところ英文です)を参照してください。

概要

PagerDutyとのDevCSの統合は、プロジェクトレベルで行われます。 特定のDevCSプロジェクトに2つのサービスを統合するには、以下の作業を行う必要があります。

  1. DevCSプロジェクト用のPagerDutyサービスを作成します。
  2. PagerDutyサービスにユーザーを追加します。
  3. PagerDuty REST APIキーを取得します。
  4. DevCSでPagerDutyのwebhookを設定します。

DevCSプロジェクト用のPagerDutyサービスを作成する

DevCSのすべてのプロジェクトは、ユニークなPagerDuty / DevCSサービス統合に通知を送信する必要があります。

プロジェクトのPagerDutyサービスを作成するには:

  1. PagerDutyで、Configuration タブ – >Servicesをクリックします 。
  2. New Serviceをクリックします。
  3. Add New Serviceページで、サービスのタイトル(DevCSプロジェクト名など)を入力します。

PagerDutyサービスにユーザーを追加する

PagerDutyサービスを設定したら、DevCSから通知イベントを受信できるように、ユーザーを追加して招待する必要があります。

PagerDutyサービスにユーザーを追加するには:

  1. PagerDutyで、Configuration タブ→ Usersをクリックします 。
  2. Add Usersを選択します。
  3. チームをサービスに招待します。それにはまず各ユーザーの名前と電子メールアドレスを入力し、ユーザーの適切なロールを選択して Addをクリックします。
  4. チームにすべてのユーザーを追加したらSend Invitationsをクリックします。 これにより、すべてのユーザーに、DevCSプロジェクトに結び付くPagerDutyサービスにアクセスする方法の詳細が電子メールで送信されます。

PagerDuty REST APIキーを取得する

次に、PagerDuty / DevCS統合を完了できるように、PagerDuty APIキーを取得する必要があります。

PagerDuty REST APIキーを取得するには:

  1. Configuration メニューから、API Accessを選択します 。
  2. Create New API Keyをクリックします 。
  3. Create v2 API Key画面で、キーの説明を入力します。
  4. Create Keyをクリックします。
  5. 次のセクションで説明するように、DevCSの設定に使用するためにこの情報をコピーして保存します。

DevCSプロジェクトとPagerDutyの統合を設定する

DevCSプロジェクトとのPagerDutyの統合はwebhookを介して有効になります。

DevCSプロジェクト用のPagerDuty webhookを作成するには:

  1. DevCSプロジェクトナビゲーションバーで、Administrationをクリックします。 Oracle
  2. Webhooksをクリックします。
  3. New Webhookをクリックします。
  4. TypeドロップダウンリストからPagerDutyを選択します。 Oracle-2
  5. Name フィールドに一意の名前を入力します。
  6. API Key フィールドに、PagerDutyから取得したREST APIキーを入力します。
  7. Service フィールドで、リストから目的のPagerDutyサービスを選択します。いま作成しているwebhookは、選択したサービスにイベント通知を送信します。
  8. Senderフィールドで、Webhookによって送信されたイベントに付けられるPagerDuty登録ユーザーの名前を選択します。
  9. Webhookをトリガーするイベントの種類を選択します。Select specific events オプションを選択した場合は、Eventsで、Webhookをトリガするイベントのチェックボックスをオンにします。
  10. Doneをクリックします。