最初の EAS Workflows ジョブを実行する

ワークフローディレクトリを作成する

Expo プロジェクトのルートに .eas/workflows/ ディレクトリを作成します。EAS はこの場所にあるワークフローファイルだけを探します。

hello.yml ファイルを追加する

.eas/workflows/ の中に hello.yml という名前のファイルを作成します。このファイルでは、単一のカスタムジョブを使って最初のワークフローを定義します。このジョブは "Hello, Workflows" を出力するシェルコマンドを実行します。

name: Hello

jobs:
  greet:
    steps:
      - run: echo "Hello, Workflows" # Any shell command works here

上のワークフローでは、次の構文を使用しています。

• name は、EAS ダッシュボードに表示されるワークフローの名前です。
• jobs には、実行する 1 つ以上のジョブを記述します。各ジョブには一意の ID があります（この例では greet）。
• steps は、ジョブが順番に実行する一連のタスクです。type フィールドを持たず steps を持つジョブは、カスタムジョブです。
• run は、ステップ内で実行するシェルコマンドです。ここでは echo を実行してメッセージを出力しています。どんなシェルコマンドでも使えます。

ワークフローを手動で実行する

EAS 上でワークフローを実行するには、ターミナルウィンドウから次のコマンドを実行します。

eas workflow:run コマンドは、ワークフローファイルを EAS にアップロードします。続いてファイル内に定義されたジョブを実行し、EAS CLI がジョブの様子を確認できる EAS ダッシュボードの URL を出力します。

ジョブのログを確認する

前のステップで出力された URL をブラウザーで開きます。ワークフローのページでは、greet ジョブとそのステータスを確認できます。ジョブが完了したら、ステップの出力を展開して、出力されたメッセージ Hello, Workflows を確認します。

EAS ダッシュボードは、あらゆるワークフロージョブの確認とデバッグを行う場所です。Workflow graph には、ジョブをトリガーしたものとジョブの一意な ID が表示されます。

Workflow file タブに切り替えてみましょう。これはステップ 2 で書いたワークフローファイルで、実行時の内容がそのまま保存されています。

ヒント： プロジェクトのすべてのワークフローは Workflows ページで一覧でき、ステータスや種類で絞り込めます。

自動トリガーを追加する

既存のワークフローファイルに on.push.branches トリガーを追加してみましょう。

• on キーは、どの GitHub イベントでワークフローをトリガーするかを定義します
• push フィールドは、いつトリガーするかを定義します
• branches フィールドでは、main ブランチにコードがプッシュされたときにワークフローを自動実行する、といった指定ができます

name: Hello

on:
  push:
    branches: ['main'] # Fires on every push to main branch

jobs:
  greet:
    steps:
      - run: echo "Hello, Workflows"

branches フィールドには、GitHub リポジトリに存在する任意のブランチ名を指定できます。['main', 'develop', 'staging'] のように複数のブランチを指定すれば、そのいずれかにプッシュしたときにワークフローがトリガーされます。

変更をコミットして GitHub にプッシュする

ワークフローファイルをコミットし、main ブランチにプッシュします。

自動トリガーを確認する

ヒント： このステップは、ローカルの Expo プロジェクトが GitHub にプッシュされていて、その GitHub リポジトリが EAS に接続されていることが前提です。確認するには、git remote -v を実行してローカルリポジトリが GitHub の URL を指していることを確かめ、EAS の GitHub 設定を開いてリポジトリが接続されていることを確認します。

EAS ダッシュボードでプロジェクトの Workflows ページを開き、新しいジョブを確認しましょう。

EAS ダッシュボードでは、Workflow graph タブにこのプッシュのコミットメッセージとブランチの参照が表示されます。ワークフローのヘッダー下にあるステータス欄でも、Trigger と Triggered by が同じ情報を示しています。

hello.yml を更新する

hello.yml ファイルを更新して、カスタムジョブと事前パッケージ済みジョブを追加してみましょう。ここで使う事前パッケージ済みジョブは doc という名前で、EAS ダッシュボード上に Markdown を描画します。

name: Hello

jobs:
  greet:
    outputs:
      greeting: ${{ steps.set_greeting.outputs.greeting }} # Expose the step output at the job level
    steps:
      - id: set_greeting
        run: set-output greeting "Hello from EAS Workflows"
  show_info:
    needs: [greet] # Wait for greet to finish, then read its outputs
    type: doc # Pre-packaged job that renders Markdown on the dashboard
    params:
      md: |
        # Workflow Output
        **${{ needs.greet.outputs.greeting }}**

上のワークフローファイルは、次のことを行っています。

• greet ジョブを定義しています。これはカスタムジョブです。set-output シェル関数を使って greeting という値を設定しています。ジョブレベルの outputs フィールドがステップの出力を公開し、他のジョブから参照できるようにします。
• show_info ジョブを定義しています。needs: [greet] によって greet ジョブの完了を待ち、その出力にアクセスします。そのうえで、事前パッケージ済みの doc ジョブタイプを使って EAS ダッシュボードに Markdown ドキュメントを描画します。この Markdown の内容には、前のジョブで設定した greeting の値が含まれます。

ヒント： EAS Workflows では、ジョブはデフォルトで並列に実行されます。ジョブを待たせるのが needs フィールドです。needs を使うジョブが開始する前に正常終了していなければならないジョブの ID を並べます。needs に並べたジョブが失敗した場合、依存する側のジョブはスキップされます。

連結したワークフローを実行する

連結されたジョブの動きを確認するために、ターミナルウィンドウから次のコマンドを実行します。

EAS CLI が出力した EAS ダッシュボードのリンクを開きます。Logs の下を見ると、まず greet ジョブが実行されているのが分かります。それが完了すると show_info ジョブが実行され、前のジョブの出力を使って Markdown の内容が描画されます。