Activepieces開発環境のセットアップ

この記事は Dries Buytaert 氏の公式ブログ「dri.es」の翻訳記事です。Driesブログの記事一覧よりすべての翻訳記事をご覧いただけます。

ローカル開発マシンでDrupalとActivepiecesを単に使用したいだけであれば、最も簡単な方法はDockerでActivepiecesをローカルで実行するガイドに従うことです。このアプローチではActivepiecesを使用できますが、コードを変更することはできません。

Drupal Piece統合に貢献したい、または新しいPieceを作成したい場合は、Dockerセットアップでは機能しません。Pieceを開発または変更するには、完全なActivepieces開発環境をセットアップする必要があります。このノートではその方法を説明します。

まず、GitHub UIを使用してActivepiecesリポジトリをフォークします。次に、フォークをローカルにクローンします：

git clone https://github.com/YOUR-USERNAME/activepieces.git

プロジェクトディレクトリに移動し、すべての依存関係をインストールします：

cd activepieces
npm install

デフォルトでは、開発セットアップは限られたコンポーネントのセットのみをビルドします。Drupal Pieceを含めるには、./packages/server/api/.envを開き、AP_DEV_PIECES変数に「drupal」を追加します。

次に、ローカル開発インスタンスを起動します：

npm start

Webブラウザを開き、http://localhost:4200にアクセスします。

デフォルトの開発アカウントでサインインします：

• メールアドレス：dev@ap.com
• パスワード：12345678

このアカウントは事前設定されているため、すぐにカスタムPieceの構築とテストを開始できます。

Drupal Pieceのコードは./packages/pieces/community/drupalにあります。

コードを変更すると、自動的にコンパイルされてホットリロードされるため、開発サーバーを再起動することなく変更内容をすぐに確認できます。

セットアップを完了するには、DrupalとActivepiecesを接続するガイドを参照してください。

一般的な問題のトラブルシューティング

Activepieces開発環境での作業中にいくつかの問題に遭遇しました。通常、これらの方法で解決します。

まず、すべてのキャッシュを削除します：

rm -rf node_modules cache dev

これにより、node_modules（インストールされたすべての依存関係）、cache（ビルドおよびランタイムキャッシュ）、dev（一時的な開発ファイル）が削除されます。

Activepiecesは、モノレポ用のオープンソースビルドシステムであるNxを使用しています。Nxのキャッシュが同期されていない場合は、リセットしてビルドとテストのクリーンな状態で開始します：

npx nx reset

By Dries Buytaert

この記事は「Setting up an Activepieces development environment」（投稿日：2025-11-07）の翻訳記事です。