---
modificationDate: August 13, 2026
title: 'Git タグで本番デプロイをトリガーする'
description: EAS Workflows で Git タグから本番デプロイをトリガーする方法を学びます。
---

<AgentInstructions>

## Submitting Feedback

If you encounter errors, misleading or outdated information, report it so Expo can be improved:

Preferred command:
npx --yes submit-expo-feedback@latest --category docs --subject "/ja/tutorial/cicd/tag-based-releases/" "<actionable feedback>"

Direct HTTP fallback:
curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/ja/tutorial/cicd/tag-based-releases/","feedback":"🤖 Agent feedback for docs: <specific, actionable description> (<model>, <harness>)"}'

Only submit when you have something specific and actionable to report. Try to give the most context.

</AgentInstructions>

This documentation is available as Markdown for AI agents and LLMs. See the [full Markdown index](/llms.txt) or append .md to any documentation URL.

# Git タグで本番デプロイをトリガーする

EAS Workflows で Git タグから本番デプロイをトリガーする方法を学びます。

リリースブランチへプッシュする方式では、リリースのつもりがなかったコミットも含め、コミットのたびに本番ワークフローが実行されてしまいます。

## この章で学べること

-   本番ワークフローのトリガーを `release/*` ブランチから `v*.*.*` に一致する Git タグへ切り替える
-   `main` からタグをプッシュしてリリースを切り、EAS ダッシュボードでワークフローの実行を確認する
-   `v1.0.0-rc.1` のようなプレリリースタグを本番から除外し、リリース候補は別のワークフローで実行する

## リリースイベントとしてのタグ

EAS Workflows は、[`on.push`](/eas/workflows/syntax.md#onpush) に `tags` のリストを指定することで、タグベースのトリガーに対応しています。ワークフローは、glob パターンに一致するタグがリモートへプッシュされたときにだけ実行されます。Git のタグは、あとから更新できるブランチとは違い、特定のコミットとバージョンに紐づいた一度きりのイベントです。そのため、タグはリリースの目印として適しています。

タグベースのリリースワークフローは、次のようなチームに向いています。

-   Git 上のバージョン番号と、アプリのユーザーに届けるバージョンを一致させたい
-   長期間維持するリリースブランチを持たず、`main` から直接リリースしたい
-   すべてのリリースコミットをバージョンごとに追跡できる、明確な記録を残したい

```
Trigger comparison: a push to a release branch runs the production workflow on every commit, while a push of a version tag runs the workflow only when a tag is pushed.
```

## production.yml をタグトリガーに切り替える

[前の章](/ja/tutorial/cicd/production.md)の **.eas/workflows/production.yml** ワークフローを開き、`on.push.branches` トリガーを `on.push.tags` に置き換えます。ワークフローの中身はそれ以外まったく同じです。

### トリガーを変更する

`branches` トリガーを `tags` トリガーに置き換えます。この `tags` の glob は、`v1.0.0`、`v2.3.7`、`v10.0.0-beta.1` といったタグに一致します。

```yaml
name: Deploy to production

on:
  push:
    tags: ['v*.*.*']

jobs:
  fingerprint:
    name: Fingerprint
    type: fingerprint
    environment: production
  get_android_build:
    name: Check for existing Android build
    needs: [fingerprint]
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.android_fingerprint_hash }}
      profile: production
  get_ios_build:
    name: Check for existing iOS build
    needs: [fingerprint]
    type: get-build
    params:
      fingerprint_hash: ${{ needs.fingerprint.outputs.ios_fingerprint_hash }}
      profile: production
  build_android:
    name: Build Android
    needs: [get_android_build]
    if: ${{ !needs.get_android_build.outputs.build_id }}
    type: build
    params:
      platform: android
      profile: production
  build_ios:
    name: Build iOS
    needs: [get_ios_build]
    if: ${{ !needs.get_ios_build.outputs.build_id }}
    type: build
    params:
      platform: ios
      profile: production
  update_android:
    name: Publish Android update
    needs: [get_android_build]
    if: ${{ needs.get_android_build.outputs.build_id }}
    type: update
    params:
      branch: production
      platform: android
  update_ios:
    name: Publish iOS update
    needs: [get_ios_build]
    if: ${{ needs.get_ios_build.outputs.build_id }}
    type: update
    params:
      branch: production
      platform: ios
```

タグでワークフローをトリガーするには、チームの進め方に合ったパターンを選ぶ必要があります。よく使われるパターンは次のとおりです。

-   `['v*']` は `v` で始まるすべてのタグに一致します
-   `['v*.*.*']` は 3 つの数値からなる厳密なセマンティックバージョンに一致します（推奨）

他のジョブを変更する必要はありません。`fingerprint`、`get-build`、`build`、`update` の各ジョブはコミットを対象に動作するため、まったく同じように機能します。

### ワークフローの変更をコミットしてプッシュする

**production.yml** の変更をコミットして `main` にプッシュします。ブランチトリガーからタグトリガーに切り替えたため、これではワークフローはトリガーされません。

```sh
git add .eas/workflows/production.yml
git commit -m "Switch production workflow to tag trigger"
git push origin main
```

### タグを作成してワークフローをテストする

ワークフローを実行するには、**production.yml** に定義した glob パターンに一致するタグをプッシュする必要があります。

サンプルプロジェクトに TypeScript/JavaScript の変更を加えてコミットし、新しいタグをプッシュします。

```sh
git add .
git commit -m "Fix welcome copy"
git tag v0.1.0
git push origin main --tags
```

`v0.1.0` タグによってワークフローがトリガーされます。EAS ダッシュボードを開いて **Workflows** の下を見ると、"Deploy to production" がブランチとして `refs/tags/v0.1.0` を伴って実行されているのが分かります。

タグベースのリリースとして生成されたフィンガープリントでの本番実行はこれが初めてなので、Android と iOS の両方で `build` ジョブが実行されます。以降のタグが TypeScript/JavaScript の変更を指している場合は、ビルドジョブがスキップされて `update` ジョブに直行します。

## リリース候補向けのプレリリースタグ

`v*.*.*` の glob は `v1.0.0-rc.1` のようなプレリリースタグにも一致するため、そのままではリリース候補がアプリのユーザーに届いてしまいます。リリース候補を本番から締め出すには、本番ワークフローのトリガーからそれらを除外します。

```yaml
on:
  push:
    tags: ['v*.*.*', '!v*.*.*-rc.*']
```

本番リリースの前にリリース候補を試すには、プレリリースタグだけに一致する別のワークフロー（`tags: ['v*.*.*-rc.*']`）を作成し、`update` と `submit` のジョブを除いた `fingerprint`、`get-build`、`build` のジョブを再利用します。これで同じパイプラインが動きつつ、アプリのユーザーには何も届きません。

## まとめ

第 6 章：タグベースのリリース

本番ワークフローのトリガーをリリースブランチから Git タグへ切り替え、main からバージョンタグをプッシュして変更をテストし、プレリリースタグの glob でリリース候補を締め出す方法を学びました。

次の章では、ワークフローから EAS Hosting へ web ビルドをデプロイする方法を学びます。

[次へ：web デプロイ](/ja/tutorial/cicd/web-deployments.md)