スマホからデプロイする方法の比較|GitHub Actions・デプロイフック・ショートカット
この記事は「Pocket Actions」の開発者が書いています。自分のアプリも比較に入れていますが、向いていない場面もそのまま書きます。各サービスの仕様は確認日時点の公式ドキュメント(リンク先)にもとづき、確かめられなかったことは「未確認」としています。
外出先で「デプロイだけしたい」とき
コードはもうmainに入っている。あとはデプロイを1回走らせるだけ。でもパソコンは手元にない。こんな場面はよくあります。
- 本番の文言の誤りを直したPRが、移動中にマージされた
- 予約投稿の記事を、決まった時間に公開したい
- 外部のデータ(CMSなど)を更新したので、静的サイトをビルドし直したい
コードをスマホで書くのではなく、すでにある仕組みを、スマホから正しく起動するのが目的です。その方法を比べます。
比較の観点
- 手軽さ:何回タップすればデプロイが始まるか
- 安全性:スマホに何を置くか(トークンやURL)、漏れたらどうなるか
- 対象:どのブランチ、どの環境をデプロイできるか
- 結果の確認:成功・失敗をスマホで確かめられるか
- 準備:最初に何を用意する必要があるか
方法1:GitHub公式アプリでワークフローを実行
デプロイをGitHub Actionsのワークフローで行っているなら、on: workflow_dispatchを足すだけで、GitHub公式アプリから手動実行できます(GitHub Changelog)。
- 長所:無料。アカウントでサインインするのでトークンは不要。ブランチを選べる。ログもその場で見られる
- 短所:リポジトリ → Actions → ワークフロー → 実行、と画面をたどる必要があり、毎日使うには手数が多い
workflow_dispatchは、ワークフローのファイルがデフォルトブランチにあるときだけ使えます(GitHub Docs)。
方法2:VercelやCloudflare Pagesのデプロイフック
ホスティング側の「デプロイフック」は、専用のURLにリクエストを送るとビルドが始まる仕組みです。
Vercel(公式ドキュメント)
- プロジェクトの設定で、ブランチを選んでURLを作る
- GETまたはPOSTでビルドが始まり、認証は不要
- そのためURLは秘密情報として扱う必要がある
- HobbyとProでは1プロジェクトあたり5個まで。1プロジェクトにつき1時間60回まで
Cloudflare Pages(公式ドキュメント)
- 1つのフックが、設定した1つのブランチをビルドする
- 専用のURLにPOSTすると始まり、認証は不要
スマホから押すには:VercelのフックはGETでも動くので、ブラウザで開くだけで始まります(ブックマークすると履歴などからURLが漏れやすい点には注意)。POSTが必要なCloudflareは、iOSショートカットの「URLの内容を取得」でPOSTします。
- 長所:最も簡単。GitHubのトークンが要らない
- 短所:URLを知っていれば誰でもデプロイできる。テストなどの前処理はホスティング側のビルドに含める必要がある。結果は各サービスのダッシュボードで見る
方法3:iOSショートカットでGitHubのAPIを呼ぶ
ショートカットからworkflow dispatchのAPI(POST /repos/{owner}/{repo}/actions/workflows/{id}/dispatches)を呼べば、ホーム画面のアイコンからデプロイのワークフローを始められます。
- 長所:無料。ホーム画面・ウィジェット・Siriから起動できる。
refでブランチも指定できる - 短所:URL、ヘッダー、JSONの作り込みが必要。ショートカットの中にPATが入る。実行後の成否は別途確認が必要
作り方と注意点はiPhoneショートカットでGAS・GitHub Actionsを実行する方法にまとめています。トークンは、Fine-grained PATで対象のリポジトリだけ・Actionsの書き込みだけに絞るのがおすすめです。
方法4:Pocket Actions
GitHub Actionsのworkflow_dispatchをホーム画面から1〜3タップで実行するアプリです。inputs(例:環境の選択)から入力フォームを自動で作ります。
- 長所:設定が少ない。毎回の実行が速い。入力の選択肢を間違えにくい。サーバーやログインはなく、トークンは端末内にだけ保存
- 短所(正直に)
- 実行は**
mainブランチ固定**。stagingなど別ブランチのデプロイには向かない - アプリ内でログは見られない。成否はGitHubかホスティングの通知で確認
- iOSのみ(Androidはクローズドテスト中)
- ノーコードではない。ワークフローは自分で書く
- 無料は1日5回・週17回まで。プレミアムは月額¥380または買い切り¥5,980
- 実行は**
比較表
表は横にスクロールできます
| 方法 | 手軽さ | スマホに置くもの | ブランチ | 結果の確認 | 費用 |
|---|---|---|---|---|---|
| GitHub公式アプリ | △ 画面をたどる | なし(サインイン) | 選べる | ◎ ログが見られる | 無料 |
| Vercelのデプロイフック | ◎ URLを開くだけ | フックのURL | フックごとに固定 | ダッシュボード | Vercelのプラン次第 |
| Cloudflare Pagesのフック | ○ POSTが必要 | フックのURL | フックごとに固定 | ダッシュボード | Cloudflareのプラン次第 |
| iOSショートカット+API | ○ 作れば1タップ | PAT | 指定できる | △ 自分で作る | 無料 |
| Pocket Actions | ◎ 1〜3タップ | PAT(端末内) | main固定 | △ GitHubで確認 | 無料枠あり/有料 |
GitHub Actionsの実行費用は、公開リポジトリなら標準ランナーで無料、非公開リポジトリはプランごとの無料枠を超えると課金されます(GitHub Actionsの課金)。
スマホからデプロイするときの安全策
- 本番デプロイには承認を挟む:GitHubの環境(environments)で必須レビュアーを設定すれば、押し間違えてもすぐには本番に出ません。
- デプロイのワークフローにテストを含める:パソコンで最終確認できない分、ワークフロー側でチェックします。
- フックのURLやトークンは最小・使い分け:フックはブランチごと、トークンはリポジトリごとに分け、漏れたらすぐ作り直す。
- 通知を用意する:成功・失敗がSlackやメールに届くようにしておくと、スマホで結果を確認できます。
設定の手順とつまずきやすい点
どの方法からも呼べるデプロイ用ワークフロー
方法1・3・4は、どれもworkflow_dispatch付きのワークフローを動かします。最小限の例です。
# .github/workflows/deploy.yml
name: Deploy
on:
workflow_dispatch:
inputs:
target:
type: choice
options: [preview, production]
default: preview
concurrency:
group: deploy-${{ inputs.target }}
jobs:
deploy:
runs-on: ubuntu-latest
environment: ${{ inputs.target }}
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test && npm run build
- run: ./scripts/deploy.sh "$TARGET"
env:
TARGET: ${{ inputs.target }}
DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
type: choiceにしておくと、スマホでは選ぶだけで済み、打ち間違えが起きません(ワークフロー構文)。concurrencyを付けておけば、2回押してしまっても、2つの実行が同時に走りません。environmentに必須レビュアーを設定しておくと、本番は承認するまで止まります。- ホスティングの認証情報はGitHubのシークレットに置きます。スマホに置くのは「実行を始める権限」だけです。
ショートカットからAPIを呼ぶ手順
まずパソコンのcurlで動作を確かめてから、ショートカットに移すと、問題の切り分けが楽です。
curl -L -X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer $GITHUB_TOKEN" \
https://api.github.com/repos/OWNER/REPO/actions/workflows/deploy.yml/dispatches \
-d '{"ref":"main","inputs":{"target":"preview"}}'
GitHubの現在のREST APIドキュメントでは、workflow dispatchが成功すると200が返り、本文にworkflow_run_id・run_url・html_urlが入ります(REST API)。古いAPIバージョンで本文のない204が返るかどうかは未確認なので、2xxなら成功と考えてください。
ショートカットでは、次の順にアクションを並べます。
- 「メニューから選択」で「preview」「production」を用意する
- それぞれの項目に「テキスト」アクションを置き、
{"ref":"main","inputs":{"target":"preview"}}を入れる - 「URLの内容を取得」で、方法をPOSTにし、ヘッダーに
AcceptとAuthorization: Bearer トークンを入れ、本文に2のテキストを渡す - 「通知を表示」で「デプロイを依頼しました」と表示する
デプロイフックの場合は、「テキスト」にフックのURLを入れ、「URLの内容を取得」を方法POSTで実行するだけです。
よくあるエラー
表は横にスクロールできます
| 症状 | 主な原因 | 対処 |
|---|---|---|
| 404 Not Found | トークンがそのリポジトリを見られない、または名前の打ち間違い。非公開リポジトリでは403ではなく404が返ります(トラブルシューティング) | トークンの対象リポジトリとファイル名を確認する |
| 422(workflow_dispatchがない) | refのブランチのワークフローにトリガーがない | そのブランチにマージする |
| 実行が待機したまま進まない | 環境の承認待ち | GitHubで承認する(公式アプリでもできます) |
エラーメッセージの文言は公式に記載がないため、表の文言は目安です(未確認)。
戻すときの手段も用意する
VercelとCloudflare Pagesには、以前のデプロイに戻す機能があり、スマホのブラウザからも操作できます(Vercel、Cloudflare Pages)。GitHub Actionsでデプロイしている場合は、version入力(タグやコミット)を足してactions/checkoutのrefに渡せば、同じボタンで古い版を出し直せます。Pocket Actionsで実行が始まるのはmainですが、チェックアウトするのは入力したタグなので、この方法なら戻せます。
タイプ別のおすすめ
- Vercel・Cloudflare Pagesの静的サイトで、ビルドし直すだけ:デプロイフック
- たまにしかデプロイせず、ログもその場で見たい:GitHub公式アプリ
- ブランチを指定したい、無料で済ませたい:iOSショートカット+API
mainのデプロイや再ビルドを、毎日のようにすぐ押したい:Pocket Actions
使い方の一例(開発者の場合)
開発者自身がPocket Actionsでよく使うのはデプロイではなく、気になった銘柄をAIに評価させる自動化を、必要なときに実行することです。「すでにあるワークフローを、スマホから1タップで起動する」という意味では、デプロイも同じ使い方になります。
まずは無料で試す
mainをデプロイするワークフローがあるなら、1日5回まで無料で試せます。
よくある質問
スマホだけでデプロイできますか? できます。デプロイの仕組み(GitHub Actionsやデプロイフック)がすでにあれば、GitHub公式アプリ、ブラウザ、iOSショートカット、専用アプリから起動できます。
Vercelのデプロイフックに認証は要りますか? 要りません。そのためURLは秘密情報として扱ってください。Vercelのドキュメントによると、GETとPOSTのどちらでもビルドが始まります。
Pocket Actionsでstagingブランチをデプロイできますか?
できません。実行はmainブランチ固定です。別ブランチにはGitHub公式アプリかショートカットのref指定を使ってください。
押し間違えて本番に出るのが怖いです。 GitHubの環境で必須レビュアーを設定すると、実行前に承認が必要になります。
デプロイの結果はスマホで確認できますか? GitHub公式アプリならログを見られます。Pocket Actionsはアプリ内でログを見られないため、GitHubやホスティングの通知で確認してください。
関連記事
- GitHub Actionsをスマホから手動実行する方法の比較
- iPhoneショートカットでGAS・GitHub Actionsを実行する方法と、専用アプリとの違い
- Fine-grained PATとclassic PATの違い
- Pocket Actionsの更新履歴
最終確認日:2026-11-01(Vercel Deploy Hooks、Cloudflare Pages Deploy hooks、GitHub Docs)。
