独自のワークフローを作成する

テンプレートがニーズに合わない場合は、 「Create Your Own」を使用してカスタムワークフローを構築できます。ドラッグ アンド ドロップ インターフェイスを使用して、アクション カタログのアクションをプロセスに一致する自動化に連結します。

このガイドの使い方

このガイドでは、概念と完全な例を使用してワークフローを構築する方法を説明します。学習パスを選択してください:

• まずコアコンセプトを学ぶ→コアコンセプトとワークフローパターンを読んで基礎を理解し、それを応用する

• 例に従ってください→例のウォークスルーにジャンプして、EC2 自動サイズ変更ワークフローを段階的に構築します

• 参考パターン→ 独自のワークフローを構築する際のクイックリファレンスとしてワークフローパターンセクションを使用してください

  ヒント

  ワークフローは初めてですか?コアコンセプトから始めて、例に従ってください。EC2 ワークフローは、実際のシナリオにおけるすべての主要パターンを示します。

カスタムワークフローを構築する理由は何ですか?

独自のワークフローを構築して、次のことを実現します。

• テンプレートがサポートしていない独自のビジネスロジックを実装する
• 標準テンプレートを超えて複数のシステムを統合
• 条件分岐で複雑な決定を処理する
• チームの承認と通知のプロセスに合わせる

コアコンセプト

構築する前に、次の基本事項を理解してください。

エラー処理パターンの詳細については、 「ベストプラクティス」を参照してください。

クイックスタート

最初のワークフローを 5 つのステップで構築します。

1. one.newrelic.com > All Capabilities > Workflow Automationに移動し、Create Your Own [独自の作成を]選択します
2. 認証情報 (シークレット マネージャーから: ${{ :secrets:keyName }} )、設定 (リージョン、インスタンスタイプ)、およびランタイム データ (アカウント ID、集計 ID) の定義
3. カタログからアクションをドラッグし、 ${{ .steps.stepName.outputs.field }}構文で接続してデータを渡します
4. 条件分岐用のスイッチ、リストやポーリングの処理用のループ、人間の決定のための承認ゲートを挿入します。
5. 各セクションの後に実行してエラーを早期に発見し、ワークフローを開始またはスケジュールします。

主要なワークフローパターン

4 つの基本パターンで、ほとんどの自動化シナリオに対応します。各パターンについては、以下の例のチュートリアルで説明します。

スイッチを使った条件分岐

次の場合にスイッチを使用します:結果はデータに基づいて変化します (閾値チェック、 API応答、ユーザーの決定)

キー構文:

- name: hasCompleted
  type: switch
  switch:
    - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}"
      next: displayError
    - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}"
      next: displaySuccess
  next: displayUnexpected  # Default path when no condition matches

実際のアクションをご覧ください:チームの対応の処理と検証およびクリーンアップのセクションでは、Slack の反応と AWS SSM のステータスに基づいてスイッチのルーティングが表示されます。

リストを処理するためのループ

ループを使用するのは、複数のアイテムを処理する場合やアクションを繰り返す場合です。

キー構文:

# Send progress updates using range loop
- name: progressLoop
  type: loop
  for:
    in: "${{ [range(1; 5)] }}"  # Loop 5 times
    steps:
      - name: wait
        type: wait
        seconds: 10
      - name: progressMessage
        type: action
        action: slack.chat.postMessage
        version: 1
        inputs:
          channel: "${{ .workflowInputs.channel }}"
          text: "Resizing in progress..."

実際に動作しているところをご覧ください:サイズ変更セクションを実行すると、ステータスの更新にprogressLoopが使用されます。

承認ゲートと待機

承認ゲートを使用するのは、破壊的な操作やコンプライアンスの承認の前に人間の判断が必要な場合です。

キー構文:

- name: requestApproval
  type: action
  action: slack.chat.postMessage
  version: 1
  inputs:
    channel: "#approvals"
    text: "Approve? React with :thumbsup: or :thumbsdown:"

- name: getReactions
  type: action
  action: slack.chat.getReactions
  version: 1
  inputs:
    token: "${{ .workflowInputs.slackToken }}"
    channelID: "${{ .steps.requestApproval.outputs.channelID }}"
    threadTs: "${{ .steps.requestApproval.outputs.threadTs }}"
    timeout: 300  # Wait 5 minutes for reaction

- name: checkApproval
  type: switch
  switch:
    - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}'
      next: handleApproval
    - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}'
      next: handleRejection

単純な遅延の場合:

- name: waitBeforeRetry
  type: wait
  seconds: 60  # Wait 60 seconds before continuing

実際の手順をご覧ください:リクエスト チーム承認セクションでは、完全な Slack 承認ワークフローが実装されます。

ステップ間でのデータの受け渡し

データ受け渡しは次の場合に使用します: 1 つのステップの出力が別のステップの入力になる場合 (すべてのワークフローの基礎)

キー構文:

# Reference previous step outputs
awsRegion: "${{ .inputs.region }}"
instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}"

実際に動作を確認してください。すべてのセクションでデータの受け渡しが示され、各ステップは前の結果に基づいて構築されます。

ウォークスルーの例: 承認による EC2 の自動サイズ変更

この完全な例では、Slack 経由でチームの承認を得た後、CPU が急増したときに EC2 インスタンスのサイズを自動的に変更するワークフローを構築する方法を示します。 実際のシナリオでのデータ収集、条件付きロジック、外部統合、およびエラー処理を示します。

前提条件

このワークフローを構築する前に、次のものを用意してください。

• AWS : EC2 および Systems Manager の権限を持つ認証情報
• Slack : 通知用のボットトークンとチャンネル
• New Relic : アラート条件監視 EC2 CPU
• シークレット マネージャー: 構成済み (シークレット管理を参照)

ワークフローの概要

大まかなフロー:

1. データを収集する: New Relicから集計とインスタンスの詳細を取得します
2. 承認リクエスト: Slack メッセージを送信し、チームの応答を待ちます
3. サイズ変更の実行: AWS Systems Manager を使用して EC2 インスタンスのサイズを変更します
4. 検証とクリーンアップ: 結果を確認し、チームに通知し、一時的なリソースを削除します

この例では、カスタム ワークフローで使用する主要なパターン (API のクエリ、条件分岐、外部統合、ポーリング ループ、エラー処理) を示します。

ワークフロー入力

このワークフローには、入力として資格情報、設定、およびランタイム コンテキストが必要です。 機密値は、 ${{ :secrets:keyName }}構文を使用してシークレット マネージャーから取得されます。

入力カテゴリ:

• 認証: シークレットマネージャーからの AWS および Slack の認証情報
• まとめコンテキスト: New Relicからのアカウント ID と問題 ID
• 設定: リージョン、インスタンスタイプ、タイムゾーン、Slackチャンネル

ワークフローを段階的に構築する

それでは、ワークフローの各部分を構築してみましょう。各ステップには、追加する特定のアクションと、それらが示すワークフロー パターンが含まれます。

次のステップ

実行と管理

• ワークフローの開始とスケジュール: 手動でトリガーするか、自動的にスケジュールします。
• ワークフローの管理: ワークフローを編集、バージョン管理、複製、または非アクティブ化します。

改善する

• ベストプラクティス: エラー処理、シークレット管理、パフォーマンス、テスト。
• アクション カタログ: AWS、Azure、GCP、HTTP、データ変換。
• ワークフローの例: より現実的な自動化シナリオ。

規模

• ワークフロー自動化 API : インフラストラクチャをコードとして API 経由でデプロイします。
• ワークフローの制限: タイムアウト、アクションの制限、ペイロードの制約。