---
title: "Catalyst Maven プラグイン"
url: https://docs.catalyst.zoho.com/ja/tools/maven-tools/maven-plugin/
description: "Catalystは、Catalyst Mavenアーキタイプで作成した関数を簡単にパッケージ化、サーブ、デプロイできるMavenプラグインを提供しています。"
last_updated: 2026-08-17T12:16:04Z
service: Serverless
type: general
---

# Catalyst Maven Plugin

### はじめに

`catalyst`プラグインは、アーキタイプからBasic I/OまたはAdvanced I/O関数を初期化した後、Mavenプラグインの下に利用可能になります。このプラグインの下に、以下に示す個別のコマンドがあり、Catalyst関数およびMavenアーティファクトに対してさまざまな操作を実行できます。

![maven-plugins](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-plugins.webp)

`serve`および`deploy`コマンドの実行は、リクエストが認証された後に行われます。Catalystは現在、[Catalyst CLI認証](https://docs.catalyst.zoho.com/ja/cli/v1/login/login-from-cli/)とは独立した、Mavenプラグイン用のプロプライエタリ認証を提供しています。これらのコマンドを実行すると、IDEが認証トークンの生成を求めるプロンプトを表示し、作成されたトークンはローカルシステムに保存されます。packageおよびhelpコマンドは認証が不要です。

### パッケージ

Catalystの`package`コマンドはMavenプラグイン専用で、CLIでは利用できません。これにより、Java関数ディレクトリを実行可能なバンドルとしてパッケージ化できます。

> **注意:** サーブまたはデプロイする前に、関数を手動でパッケージ化できます。ただし、最初に`package`コマンドを実行せずに直接サーブまたはデプロイする場合、Catalystはサーブまたはデプロイの前に関数を自動的にパッケージ化します。

#### Catalyst Mavenプラグインで関数をパッケージ化する

以下に説明する方法で、Java Basic I/OまたはAdvanced I/O関数をパッケージ化できます。この例では、VS Code IDEでこのコマンドを実行しています。

Mavenツールの**Plugins > catalyst**の下にある**`package`**コマンドをクリックします。

![maven-package-1](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-package-1.webp)

IDEのターミナルで実行の進行状況を追跡できます。関数はMavenの[`SNAPSHOT`](https://maven.apache.org/guides/getting-started/index.html#what-is-a-snapshot-version)としてJARファイル形式にコンパイルされます。Mavenプロジェクトディレクトリの`target`フォルダに、デプロイ可能なバンドル全体`catalyst-archive.zip`が追加されています。

![maven-package-2](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-package-2.webp)

`target`ディレクトリには、ビルドアーカイブとメイン関数の`SNAPSHOT` JARとともに、すべてのコンパイル済みファイル、ライブラリ、およびその他のMaven依存関係が含まれます。

![maven-catalyst-archive](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-catalyst-archive.webp)

`catalyst-archive`には、Java SDK、コンパイル済みソースファイル、`[catalyst-config.json](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/functions-directory/#catalyst-config-json-file)`、および`[pom.xml](https://docs.catalyst.zoho.com/ja/tools/maven-tools/pom-xml/)`を含むデプロイ可能なライブラリファイルが含まれます。

![maven-catalyst-archive-structure](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-catalyst-archive-structure.webp)

これで、関数をローカルでサーブするか、リモートプロジェクトにデプロイできます。

### サーブ

Catalyst Mavenプラグインの`serve`コマンドは、CLIコマンドの`[catalyst serve](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/introduction/)`と同様です。リモートプロジェクトにデプロイする前に、システム内のlocalhostを通じて関数をサーブしてテストできます。Basic I/OおよびAdvanced I/O関数の両方をサーブし、テスト用のローカルエンドポイントを取得できます。

さらに、IDEのデバッガーを活用してライブサーブセッションにアタッチし、テスト体験を向上させることができます。Catalystは、サーブする関数のホットリロードも可能にします。これにより、関数のコードを変更し、再コンパイルや再サーブを行うことなく、更新がライブで反映されるのを確認できます。

> **注意:**

* 関数に関連付けられたProject IDとOrg IDは、関数をサーブする前に`[pom.xml](https://docs.catalyst.zoho.com/ja/tools/maven-tools/pom-xml/)`で設定する必要があります。

* 関数はサーブされる前にバンドルする必要があります。プラグインから[パッケージ化](https://docs.catalyst.zoho.com/ja/tools/maven-tools/maven-plugin/#パッケージ)するか、直接サーブすることができ、その場合は`package`コマンドが自動的に実行されます。

* サーブを成功させるには、Mavenプロジェクトのディレクトリが、すべての必要なMavenおよびCatalyst依存関係ファイルを含む標準構造になっている必要があります。

#### Catalyst Mavenプラグインで関数をサーブする

以下に説明する方法で、Java Basic I/OまたはAdvanced I/O関数をサーブできます。この例では、VS Code IDEでこのコマンドを実行しています。

1. Mavenツールの**Plugins > `catalyst`**の下にある`serve`コマンドをクリックします。

![maven-serve-1](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-1.webp)

IDEのターミナルにサーブセッションの進行状況が表示されます。

![maven-serve-2](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-2.webp)

2. 有効な認証トークンが検出されない場合、Catalystはサーブリクエストの認証を求めるプロンプトを表示します。ターミナルに表示されたURLをブラウザウィンドウで開きます。

![maven-serve-3](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-3.webp)

3. ブラウザウィンドウで**Accept**をクリックします。これにより、Catalystアカウントが認証され、Catalyst CLIに要求された権限が付与されます。

![maven-serve-4](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-4.webp)

ウィンドウを閉じて、IDEに戻ることができます。

4. Catalystはデフォルトのポート3010でローカルサーバーを起動します。ターミナルからサーブされた関数のローカルURLにアクセスします。

![maven-serve-5](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-5.webp)

> **注意:** IDEによっては、ホストされたリソースをテストするためのデバッグコンソールが自動的に起動する場合があります。自動的に起動しない場合は、サーブセッションに自分でデバッガーをアタッチすることもできます。

ターミナルには実行されたアクションのライブログが表示されます。IDEによっては、コマンドの実行を終了してサーブセッションを終了できます。

### デプロイ

Catalyst Mavenプラグインの`deploy`コマンドは、CLIコマンドの`[catalyst deploy](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/introduction/)`と同様です。テストが完了した後、関数をリモートプロジェクトにデプロイできます。Basic I/OおよびAdvanced I/O関数の両方をデプロイし、デプロイされたURLエンドポイントを取得できます。

> **注意:**

* 関数に関連付けられたProject IDとOrg IDは、関数をデプロイする前に`[pom.xml](https://docs.catalyst.zoho.com/ja/tools/maven-tools/pom-xml/)`で設定する必要があります。

* 関数はデプロイされる前にバンドルする必要があります。プラグインから[パッケージ化](https://docs.catalyst.zoho.com/ja/tools/maven-tools/maven-plugin/#パッケージ)するか、直接デプロイすることができ、その場合は`package`コマンドが自動的に実行されます。

* デプロイを成功させるには、Mavenプロジェクトのディレクトリが、すべての必要なMavenおよびCatalyst依存関係ファイルを含む標準構造になっている必要があります。

#### Catalyst Mavenプラグインで関数をデプロイする

以下に説明する方法で、Java Basic I/OまたはAdvanced I/O関数をデプロイできます。この例では、VS Code IDEでこのコマンドを実行しています。

1. Mavenツールの**Plugins > `catalyst`の下にある`deploy`**コマンドをクリックします。

![maven-deploy-1](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-deploy-1.webp)

IDEのターミナルにコマンド実行の進行状況が表示されます。

![maven-deploy-2](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-deploy-2.webp)

2. 有効な認証トークンが検出されない場合、Catalystはデプロイリクエストの認証を求めるプロンプトを表示します。ターミナルに表示されたURLをブラウザウィンドウで開きます。

![maven-deploy-3](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-deploy-3.webp)

3. ブラウザウィンドウで**Accept**をクリックします。これにより、Catalystアカウントが認証され、Catalyst CLIに要求された権限が付与されます。

![maven-serve-4](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-serve-4.webp)

ウィンドウを閉じて、IDEに戻ることができます。

4. ターミナルにアクセス可能な関数のデプロイ済みURLが表示されます。

![maven-deploy-4](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-deploy-4.webp)

> **注意:** CatalystアプリケーションのURLの`/server/`部分は関数を示します。Basic I/O関数のURLは関数名の後に`/execute`が含まれますが、Advanced I/O関数のURLにはそのキーワードは含まれません。

これで、リモートコンソールのプロジェクト内の関数にアクセスできるようになります。

### ヘルプ

Mavenプラグインは、実行するとプラグイン内のすべてのコマンドのヘルプ情報を表示するhelpコマンドを提供します。

![maven-help-1](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-help-1.webp)

IDEのターミナルで詳細を確認できます。

![maven-help-2](https://catalyst-docs-development.zohostratus.in/images/catalyst-extension/maven/maven-help-2.webp)