お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Functionのセットアップ

Functionタイプのセットアップ

  1. プロジェクトディレクトリに移動し、CLIで以下のコマンドを実行して、プロジェクトにFunctionディレクトリをセットアップできます:
copy
$
catalyst functions:setup


手順はプロジェクト初期化時のFunctionディレクトリの初期化と同じです。

  1. 開発したいFunctionのタイプを選択し、Enterを押します。
    Setup Functions Type
    Catalystで開発できる6種類のFunctionは、Basic I/O、Advanced I/O、Event、Cron、Browser Logic、Integration、およびBrowser Logic Functionです。Functionのタイプとその目的の詳細については、 Functionヘルプページ をご参照ください。

Integration Function:

Integration Function以外のすべてのFunctionタイプでは、CLIの初期化プロセスは同じです。リストから_Integration_を選択した場合、次のステップに進む前に以下の2つの追加ステップを実行する必要があります:

i. 統合するサービスを選択します。現在はCliq統合のみ選択できます。
Setup Integration Functions

ii. 必要なハンドラを選択します。詳細については、Integration Functionヘルプページをご参照ください。
Setup Integration Functions残りのセットアッププロセスはすべてのFunctionタイプで同じです。プロセスはFunctionスタックによってのみ異なります。

注意: Cliq Integration Functionは現在、EU、AU、IN、またはCAデータセンターからアクセスするCatalystユーザーには利用できません。ConvoKraft Integration Functionはすべてのデータセンターからアクセスするユーザーが利用可能です。

  1. サーバーサイドFunctionを開発するスタックを選択し、Enterを押します。リストにはサポートされているすべてのランタイムが表示されます。リストからJavaNode.js、またはPythonの最新サポートランタイムを選択できます。
注意: catalyst functions:addコマンドを使用して、単一のFunctionディレクトリにJava、Node.js、またはPythonのFunctionを含めることができます。

任意のタイプのJava Functionのセットアップ

  1. Java Functionをセットアップする場合、サポートされているランタイムから必要なものを選択します:Java 8Java 11Java 17

    Set up Java Function


注意: Java Functionスタックのバージョンを選択する前に、システムに関連するJDKがインストールされていることを確認してください。以下のリンクから関連するJDKをインストールすることもできます:
  1. プロンプトが表示されたらJava Functionの参照名を入力してEnterを押し、Java Functionのメインクラス名を入力してEnterを押します。CLIはJava SDKパッケージをダウンロードし、Functionのセットアッププロセスを完了します。 Setup Java Function

  1. Java 11またはJava 17のFunctionを初めて初期化またはセットアップする場合、システムにインストールされているJDKのパス情報を追加で設定する必要があります。この情報は、ローカルシステムに隠しファイルとして存在する特定の設定ファイルに設定できます。インストールされたJDKのパスは、config:set <key=value> CLIコマンドを使用して設定する必要があります。このコマンドの詳細については、こちらのヘルプドキュメントをご参照ください。

設定ファイルにパス情報を以下の例のように設定します:

Java 11

copy
$
catalyst config:set java11.bin=/Library/Java/JavaVirtualMachines/jdk-11.0.17.jdk/Contents/Home/bin

Java 17

copy
$
catalyst config:set java17.bin=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin

注意:
  • 上記のコマンドに記載されているパスをお使いのJDKパスに置き換えてください。
  • ローカルシステムがWindows OSで動作している場合は、パスをダブルクォーテーションで囲んでください。たとえば、Java 11のパスを以下のように設定します:
copy
$
catalyst config:set java11.bin="/Library/Java/JavaVirtualMachines/jdk-11.0.17.jdk/Contents/Home/bin"

catalyst_cli_functions_java_jdk_setup

Java Functionのフォルダには、メインの.javaクラスファイル、ライブラリJARファイル、catalyst-config.json、およびその他の設定ファイルが作成されます。これらの値はcatalyst.json設定ファイルに更新されます。


Java Function Directory
Java Functionのディレクトリ構造の詳細については、プロジェクトディレクトリ構造ヘルプページをご参照ください。

任意のタイプのNode.js Functionのセットアップ

  1. Node.js Functionをセットアップする場合、サポートされているランタイムから必要なものを選択します:Node 20Node 18Node 16Node 14Node 12


  1. プロンプトが表示されたらNode Functionのパッケージ名を入力し、Enterを押します。
    Set up Node Function

  2. エントリポイントファイルの名前を入力し、Enterを押します。
    Set up Node Function

  3. Function作成者の名前を入力し、Enterを押します。
    Set up Node Function

  4. CLIがnode依存関係のインストールを許可するよう求めます。Yを押してインストールを確認し、Enterを押して選択を確定します。必要な依存関係をすべてインストールしないと、Function実行時にエラーが発生する可能性があります。
    Set up Node Function
    CLIはNode.js SDKパッケージをダウンロードし、Functionのセットアッププロセスを完了します。

    注意: Catalystでは、Expressテンプレートを使用してAdvanced I/O Node.js Functionを作成でき、Express.jsモジュールがインストールされます。ただし、CLIからExpressテンプレートを作成することはできません。特定のFunctionのディレクトリからnpm install express –saveを実行して、システムにExpressを独立してインストールし、そのFunctionでExpressモジュールを使用できます。Expressテンプレートの詳細については、Advanced I/O Functionヘルプページをご参照ください。

Node Functionのディレクトリは、.jsメインFunctionファイル、catalyst-config.json、および依存関係をインストールした場合は必要なnodeモジュールと設定ファイルでセットアップされます。これらの値はcatalyst.json設定ファイルに更新されます。
Node Function Directory
Node.js Functionのディレクトリ構造の詳細については、プロジェクトディレクトリ構造ヘルプページをご参照ください。

任意のタイプのPython Functionのセットアップ

  1. Python Functionをセットアップする場合、サポートされているランタイムから必要なものを選択します:Python 3.9

  1. プロンプトが表示されたらPython Functionのパッケージ名を入力し、Enterを押します。

  2. エントリポイントファイルの名前を入力し、Enterを押します。

Set up Python Function

Python Functionの初期化が成功すると、Catalyst Python SDKパッケージがプロジェクトに自動的にインストールされ、requirements.txtファイルにエントリが追加されます。

注意: Python Functionを初めて初期化する場合、システムにインストールされているPythonのパス情報を追加で設定する必要があります。この情報は、ローカルシステムに隠しファイルとして存在する特定の設定ファイルに設定できます。パスはconfig:set <key=value> CLIコマンドを使用して設定する必要があります。このコマンドの詳細については、こちらのヘルプドキュメントをご参照ください。

Python Functionのディレクトリは、.pyメインFunctionファイル、catalyst-config.json、およびrequirements.txt設定ファイルでセットアップされます。これらの値はcatalyst.json設定ファイルに更新されます。

Set up Python Function


Python Functionのディレクトリ構造の詳細については、プロジェクトディレクトリ構造ヘルプページをご参照ください。

注意:
  • Java、Node.js、またはPythonのFunctionディレクトリには、任意の数のサブフォルダとファイルを追加できます。メインFunctionファイルの他に、Functionのフォルダにはその他のサブFunctionを含めることができます。ただし、設定ファイルと依存関係はFunctionディレクトリのルートに配置する必要があります。
  • Node.js Functionのサブfunctionは、Catalystコンソールまたは外部エディタを使用して作成できます。ただし、JavaおよびPythonのFunctionはCLIからのみ作成および更新できます。
  • catalyst pullコマンドを使用して、コンソールから既存のFunctionディレクトリをローカルシステムにプルすることもできます。

セットアップしたFunctionで作業を開始できます。パッケージをCatalystコンソールにアップロードしてコンソールのオンラインエディタを使用してコーディングするか、お好みのエディタを使用できます。また、functions shellを使用してFunctionのコードをテスト・実行し、コンソールにデプロイすることもできます。

最終更新日 2026-02-23 18:09:41 +0530 IST