> This page is for プラットフォーム, version レガシー.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://developer.frame.io/platform/v4/llms.txt
> - V4 Experimental: https://developer.frame.io/platform/v4-experimental/llms.txt
> - レガシー: https://developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.frame.io/_mcp/server.

# カスタムアクションをデプロイする 3 つの方法

## 利用開始
カスタムアクションの最速のデプロイ方法は？  最も汎用性が高く、ワークフローを完全にカスタマイズできるのは、どのような設定でしょうか？  カスタムアクションを受け取って処理するために選択する環境は、最終的なワークフロー手順でデータを使用して実行できることを決定する重要な要素です。  基本的な選択肢は次のとおりです。
1. Zapier、Integromat、Microsoft Power Automate などの自動化プラットフォームを使用したノーコードデプロイ
2. AWS Lambda や Azure Functions などのローコードソリューション。完全にメンテナンスされた環境で、シンプルなスクリプトを「ジョブ」として実行可能
3. お客様が運用および保守するサーバー

次の図に、カスタムアクションのアーキテクチャを示します。

![カスタムアクションの図](//images.ctfassets.net/4a2bckdt649q/775seuYAm5iWc8ToGddzqu/f4abeef79d5ca61b04bd6f65b7593b2f/a73b943-custom_actions_architecture.png)

### ノーコード：Zapier へのデプロイ
Zapier の「クリックで作れる」インターフェイスは、アセット、コメント、ステータスイベントを Frame.io から一般的なアプリや生産性ツールに送信するための基本的なオートメーションに適しています。

![Zapier のセットアップ](//images.ctfassets.net/4a2bckdt649q/7J4tu37VUNxYkUqcmLM7wZ/1453834e051781da7744b4a885debf15/548d2d6-zapier_catch_webhook.png)

#### 長所：
- 使い方が簡単です。  ポイントアンドクリックでオートメーションを作成できます。
- [Zap 履歴](https://zapier.com/learn/getting-started-guide/task-history/)は Zapier のランタイムログツールで、各オートメーション実行での各ワークフロー手順のデータ I/O がまとめられています。
- プレミアムアカウントを購入すると、オートメーションに分岐ロジックを追加するためのツールである[パス](https://zapier.com/paths)を利用できます。

#### 短所：
- Zapier の Webhook サポートには制約があり、カスタムアクションの実行時に Frame.io ユーザーに返す詳細なメッセージやインタラクションをサポートしていません。  この制約について、Zapier のサポート文書では次のように説明しています。

> 私たち [Zapier] は、Webhook の背後に Zap があるかどうか、またはそれが一時停止されているかどうかによらず、Webhook の収集時に、デバッグ情報のペイロードを含む成功メッセージを必ず返します...レスポンスは Zap がトリガーされる前に送信され、Webhook リクエストで実行されるので、Catch Hook URL に送信するリクエストへのレスポンスをカスタマイズする方法はありません。

- カスタムアクションが正しく機能していることを確認する際、Zapier の UI は煩雑な場合があります。  例えば、テスト中に[テストデータ](https://zapier.com/help/create/basics/change-the-test-data-in-your-zap-trigger)をチェックして更新する必要があります。テストデータがライブデータと一致しない場合には、Zap 設計が実際には正しくても、Zapier が「偽陰性」をスローしてエラーを示すことがあります。  `File URL` などの重要なデータが、タスクはそれを予期しているのに利用できない場合、Zap がエラーで終了したり、予期した機能を実行しなかったりすることがあります。

<Info title="このためのガイドを用意しました。">
Zapier 統合の設計方法については、[Zapier にカスタムアクションをデプロイする方法](/docs/custom-actions/deploy-custom-actions-to-zapier)に関する詳細なガイドなど、広範なガイドを用意しています。
</Info>

## ローコード：AWS へのデプロイ
カスタムアクションを AWS の API Gateway に送信して、Amazon の[巨大な](https://aws.amazon.com/what-is-aws/)クラウドサービスと統合できます。  最もシンプルなパターンは、カスタムアクションに含まれる Frame.io イベントを、サーバーレス関数を実行するためのコンピューティングサービスである AWS Lambda に中継することです。  ファイルアーカイブサービスの設計例を次に示します。

![AWS Lambda](//images.ctfassets.net/4a2bckdt649q/6elz3dJIRNnubtPjVfNF3T/ef59a0b674c90c3edd90b3d379e80102/2ef81ac-action-lambda.png)
#### 長所：
- サービスに課金される前に、[AWS 無料利用枠](https://aws.amazon.com/free/?all-free-tier.sort-by=item.additionalFields.SortRank&all-free-tier.sort-order=asc&all-free-tier.q=Lambda&all-free-tier.q_operator=AND)で毎月 320 万秒のコンピューティング時間が付与されます。
- API Gateway と Lambdas は、CloudWatch や X-Ray などの優れたテスト・監視ツールをサポートしています。
- サービスを拡張すると、大規模なファイルサイズ（500 GB 以上）に対応できます。

#### 短所：
- 複数のサービスをつなぎ合わせたり（Webhook -> API Gateway -> Lambda 1 -> Lambda 2）、AWS Fargate のような新しいサービスの使い方を習得したりするのに、時間がかかる場合があります。
- AWS ドキュメントは、最新情報ではなかったり、重要な詳細情報が不足していたりすることがよくあります。  例えば、API Gateway を設定する場合に、ペイロードが Base64 エンコードされるかどうかを見極めるのは簡単ではありません。
- 構成が概して少々複雑です。

[AWS へのカスタムアクションの導入の詳細手順については、ガイドを参照してください](https://medium.com/@frameiokyle/automatic-s3-backups-with-frame-io-custom-actions-and-aws-lambda-d3b8dbed0133)。  注意：カスタムアクションは、AWS に限らず、任意のクラウドコンピューティングサービス（Azure、Google Cloud Platform、Digital Ocean など）にデプロイできます。

### サーバーの実行と独自コードのホスト

クラウドサービスは非常に便利ですが、データを全体的に制御するためのワークフロー用に、お客様が独自のサーバーを開発して導入する状況も考えられます。

当社の DevRel チームでは、Python での [FastAPI サーバー](https://fastapi.tiangolo.com/features/)の開発が好まれています。  これらは簡単に作成でき、カスタムアクションのリクエスト／レスポンスパターンに適しています。

#### 長所：
- データのエンドツーエンドのフローを制御する。  これについては何の驚きもありません。
- クラウドへの追加の公開なしに、NAS またはファイルシステムにデータを同期する。

#### 短所：
- サーバーの管理、独自のセキュリティ機能の構築、ネットワーク検出の処理、負荷対策などが必要。

こちらで用意した[サンプルコード](https://github.com/Frameio/custom-actions-app-python)を複製して、カスタムアクションを処理する FastAPI サーバーをデプロイしてみましょう。

### お客様のニーズに最適な設計について話し合いましょう

要件をコミュニティに投稿してください。お客様のワークフローに最適な設計の見極めをお手伝いします。