DOCS
インテグレーションガイド / 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つのサービスを統合するには、以下の作業を行う必要があります。
- DevCSプロジェクト用のPagerDutyサービスを作成します。
- PagerDutyサービスにユーザーを追加します。
- PagerDuty REST APIキーを取得します。
- DevCSでPagerDutyのwebhookを設定します。
DevCSプロジェクト用のPagerDutyサービスを作成する
DevCSのすべてのプロジェクトは、ユニークなPagerDuty / DevCSサービス統合に通知を送信する必要があります。
プロジェクトのPagerDutyサービスを作成するには:
- PagerDutyで、Configuration タブ – >Servicesをクリックします 。
- New Serviceをクリックします。
- Add New Serviceページで、サービスのタイトル(DevCSプロジェクト名など)を入力します。
PagerDutyサービスにユーザーを追加する
PagerDutyサービスを設定したら、DevCSから通知イベントを受信できるように、ユーザーを追加して招待する必要があります。
PagerDutyサービスにユーザーを追加するには:
- PagerDutyで、Configuration タブ→ Usersをクリックします 。
- Add Usersを選択します。
- チームをサービスに招待します。それにはまず各ユーザーの名前と電子メールアドレスを入力し、ユーザーの適切なロールを選択して Addをクリックします。
- チームにすべてのユーザーを追加したらSend Invitationsをクリックします。 これにより、すべてのユーザーに、DevCSプロジェクトに結び付くPagerDutyサービスにアクセスする方法の詳細が電子メールで送信されます。
PagerDuty REST APIキーを取得する
次に、PagerDuty / DevCS統合を完了できるように、PagerDuty APIキーを取得する必要があります。
PagerDuty REST APIキーを取得するには:
- Configuration メニューから、API Accessを選択します 。
- Create New API Keyをクリックします 。
- Create v2 API Key画面で、キーの説明を入力します。
- Create Keyをクリックします。
- 次のセクションで説明するように、DevCSの設定に使用するためにこの情報をコピーして保存します。
DevCSプロジェクトとPagerDutyの統合を設定する
DevCSプロジェクトとのPagerDutyの統合はwebhookを介して有効になります。
DevCSプロジェクト用のPagerDuty webhookを作成するには:
- DevCSプロジェクトナビゲーションバーで、Administrationをクリックします。
- Webhooksをクリックします。
- New Webhookをクリックします。
- TypeドロップダウンリストからPagerDutyを選択します。
- Name フィールドに一意の名前を入力します。
- API Key フィールドに、PagerDutyから取得したREST APIキーを入力します。
- Service フィールドで、リストから目的のPagerDutyサービスを選択します。いま作成しているwebhookは、選択したサービスにイベント通知を送信します。
- Senderフィールドで、Webhookによって送信されたイベントに付けられるPagerDuty登録ユーザーの名前を選択します。
- Webhookをトリガーするイベントの種類を選択します。Select specific events オプションを選択した場合は、Eventsで、Webhookをトリガするイベントのチェックボックスをオンにします。
- Doneをクリックします。