メインコンテンツまでスキップ

メール通知の設定

通知は、Bitrise上でのアクティビティに関する更新情報です。通常はビルドの状態に関するものですが、それ以外にもさまざまな種類の通知を受け取ることができます。

組み込みのメール通知システムは、アプリケーションの作業担当者として割り当てられているすべてのユーザーに、ビルドに関するメールを送信します。メールはビルドが完了した際に送信され、ビルド成功時と失敗時の両方について設定できます。

アプリのウォッチ

自動メールを受け取るには、アプリをウォッチしている必要があります。ウォッチをオフにすると、自動メールは届かなくなります。

メール通知は、アプリケーションを最初に作成する際に自動的に設定されますが、通知設定はいつでも変更できます: メール通知設定の変更

別の方法として、専用のStepを使用してメールを送信することもできます。この方法では、通知についてさらに多くのカスタマイズが可能です: Stepを使用したメール送信

プロジェクトのウォッチClick to copy link​

Bitriseプロジェクトをウォッチすると、そのプロジェクトのメール通知を受け取れるようになります。プロジェクトのウォッチをオフにすると、自動通知は届かなくなります。

ウォッチを有効にするには:

  1. Bitrise CIを開きます。

  2. 右側のプロジェクトリストから、対象のプロジェクトを選択します。

  3. 左側でWatchingを切り替えます。

    watching-app.png

メール通知設定の変更Click to copy link​

メール通知は、プロジェクトを最初に作成する際に自動的に設定されます。ビルド成功時とビルド失敗時のそれぞれについて、次の3つの設定を選択できます。

  • 常に。これはビルド失敗時のデフォルト設定です。
  • Never。
  • 同一ブランチでビルドステータスが変化したときにメールを送信。これはビルド成功時のデフォルト設定です。つまり、ビルド#1とビルド#2がともに成功した場合、ビルド#2についての通知は届きません。ただし、ビルド#3が失敗し、その後ビルド#4が再度成功した場合は通知されます。

メール通知設定はいつでも変更でき、完全に無効にすることもできます。

  1. プロジェクトに対するAdminのロールを持つユーザー、またはEdit workflow権限を持つカスタムロールを持つユーザーで、Bitrise上のプロジェクトを開きます。

  2. プロジェクトのメインページで、Project settingsボタンをクリックします。

  3. 左側でNotificationsを選択します。

  4. 下にスクロールしてメール通知の項目を表示します。

    notifications.png

  5. ビルド成功時とビルド失敗時それぞれについて、該当するドロップダウンメニューから必要な設定を選択します。

    たとえば、通知の受信を無効にしたい場合は、両方のオプションをNeverに設定します。

Stepを使用したメール送信Click to copy link​

Send Email with Mailgun Stepを使用すると、HTML形式またはプレーンテキスト形式でカスタマイズした内容のメールを、任意のメールアドレスに送信できます。environment variablesを使用して情報を送信したり、メールにファイルを添付したりすることもできます。

Stepを使用するには、次のものが必要です。

  • Mailgunアカウント。
  • MailgunのAPIキー。
  • Mailgunのドメイン名。
Stepが必ず毎回のビルドで実行されるようにしてください

ワークフローでSend Email with Mailgun Stepを使用する場合は、前のStepが失敗した場合でも必ず実行されるように設定してください!これはStepのデフォルト設定です。この設定を変更すると、ビルドが失敗した場合にメールを受信できなくなります。

  1. MailgunのAPIキーを保持するSecret環境変数を作成します。

    キー名には$MAILGUN_API_KEYを使用することをお勧めします。これはStepの該当する入力のdefault valueです。

  2. Mailgunのドメインを保持するSecret環境変数を作成します。

    キー名には$MAILGUN_DOMAINを使用することをお勧めします。これはStepの該当する入力のdefault valueです。

  3. ワークフローの最後にSend Email with Mailgun Stepを追加します。

  4. StepのSend To emails入力を見つけます。その入力をクリックし、Select secret variableをクリックします。

  5. メールアドレスのリストを含む新しいSecret環境変数を作成します。

    キー名は任意のものを選択できます。アドレスはカンマで区切ります。

    Configuring_notifications.png

  6. メールの件名と、2種類のメール本文(ビルド成功時用とビルド失敗時用)を設定します。

    • 件名や本文などの入力項目にはenvironment variablesを挿入できます。メールには変数の値が表示されます。
    • デフォルトのメッセージには、アプリ名、ビルド番号、およびビルドが成功したか失敗したかが送信されます。
  7. 必要に応じてファイルを添付します。File attachments入力には、ファイルパスまたは環境変数を指定できます。

    複数のファイルを添付する場合は、パスをカンマで区切ります。

ビルドを実行して、メールを確認しましょう!