お知らせ:

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

Catalyst CLIのインストール

紹介

Catalyst CLIには、プロジェクトの初期化、ローカルマシンからのアプリケーションやマイクロサービスのコンポーネントの開発、テスト、デプロイを可能にするツールセットが含まれています。CLIには、Cloud Scale、Serverless、SmartBrowzなど、ほとんどのCatalystサービスに適用されるコマンドと操作が含まれています。利用可能なCLIコマンドについて学び、CLIの詳細なヘルプにアクセスするには、CLIドキュメントを参照してください。

注意: CLIはCatalystプロジェクトの開発環境で動作します。そのため、ファンクションの作成やリモートコンソールへのクライアントのデプロイなど、CLIを使用して実行するアクティビティは、プロジェクトのライブ本番環境には反映されません。アプリケーションの本番環境で有効にするには、プロジェクトを本番環境にデプロイする必要があります。

サポートされるOS:

  • Windows
  • macOS
  • Linux

サポートされるすべてのオペレーティングシステムで、このヘルプページで説明されている方法と同じ方法でCatalyst CLIをインストールできます。Catalyst CLIはすべてのプラットフォームで同じCLI機能を提供します。Catalyst CLIをインストールした後、システムのターミナルから直接Catalystプロジェクトで作業し、アプリケーションを構築できます。

前提条件

Catalyst CLIをインストールする前に、以下の前提条件がシステムにインストールされている必要があります。

Node.jsとNode Package Manager(NPM):

Catalyst CLIはNPMまたはYarnパッケージマネージャーを通じてインストールできます。

そのため、NPMをシステムにインストールしてCLIを直接インストールするか、NPMを使用してYarnパッケージマネージャーをインストールしてからCLIをインストールできます。

Node.jsとNPMがすでにインストールされているか確認するには、ターミナルで以下のコマンドを実行します。インストールされている場合は、そのバージョンが表示されます:

copy
$
node -v

copy
$
npm -v


インストールされていない場合は、公式ウェブサイトからプラットフォーム用のNode.jsをダウンロードするか、NVMなどのNodeバージョンマネージャーを使用してNode.jsとNPMをインストールできます。NPMはNode.jsのインストール時にバンドルされています。

詳細については、Node.jsヘルプドキュメントまたはNPMドキュメントを参照してください。

注意: Catalyst CLIはNode.js v14以降でのみ動作します。適切なバージョンをインストールしてください。

プログラミング言語サポート:

Catalystでは、以下の言語環境でサーバーサイドファンクションを開発できます:

  1. Node.js
  2. Java
  3. Python

開発を行う前に、これらの言語環境に必要なすべてのコンポーネントがローカルシステムにインストールされていることを確認する必要があります。

注意: これらのプログラミング言語の前提条件は、CLIからCatalystファンクションを初期化する予定があり、必要なスタックの場合にのみインストールしてください。

前のステップでNode.jsをインストールしたため、Node.jsファンクションの開発に必要なコンポーネントはすでにシステムで利用可能です。

また、サポートされているNode.jsのランタイムと対応するサポートされているSDKパッケージを手動でインストールして、そのランタイムでファンクションを開発することもできます。


Java: Javaファンクションを開発するには、プラットフォーム用の関連するJava Development Kit(JDK)をシステムにインストールします。以下をインストールする必要があります:

詳細については、JDKドキュメントを参照してください。

注意: Catalystは現在、Java SE Development Kitのバージョン81117のみをサポートしています。正確なバージョンがマシンにインストールされていない場合は、最適なパフォーマンスのために正確なJDKをインストールすることをお勧めします。

Python: Pythonファンクションを開発するには、公式ウェブサイトからプラットフォーム用のPythonバージョン3.9とPythonパッケージマネージャーのPipをインストールします。Pipパッケージマネージャーは、公式ソースからPythonをインストールするとローカルシステムに自動的にインストールされます。


CLIのインストール

このコマンドの実行には管理者権限が必要なため、管理者モードのターミナルを使用してCatalyst CLIをシステムにインストールする必要があります。Windows環境ではターミナルを管理者として実行するか、macOSやLinuxシステムなどのUNIXコマンドラインでsudoを使用してインストールコマンドを実行できます。

ターミナルで以下のコマンドを実行してCatalyst CLIをインストールします:

copy
$
npm install -g zcatalyst-cli

Yarnパッケージマネージャーを通じてインストールする場合は、ターミナルで以下のコマンドを実行します:

copy
$
yarn add zcatalyst-cli

これによりインストールプロセスが開始され、ターミナルに進捗状況が表示されます。

インストールが完了すると、CLIにこれらの詳細が表示されます。

CLIが正しくインストールされたか確認するには、以下のコマンドを実行します:

copy
$
catalyst --version

インストールに問題がなければ、コマンドはシステムにインストールされたCLIのバージョンを返します。

これで、ターミナルからcatalystコマンドにアクセスできるようになりました。

CLIコマンドのヘルプについては、CatalystリソースページからCLIドキュメントを参照してください。


Catalyst CLIを最新バージョンに更新

Catalyst CLIの新しいバージョンが利用可能な場合、CLIコマンドを正常に実行した後にターミナルにアラートメッセージが表示されます。


CLIを更新するには、ターミナルで以下のコマンドを実行します:

copy
$
npm install -g zcatalyst-cli

これにより、最新バージョンのインストールプロセスが開始されます。

注意:
  • まれに、システムのレジストリ値がCatalyst CLIの最新バージョンを反映しない場合があります。その場合、システムが古いバージョンのCLIを保持する可能性があります。これを回避するには、コマンド実行時にバージョン番号を指定してください。例えば、バージョン1.9.0に更新するには $ npm install -g zcatalyst-cli@1.9.0 を実行します。

  • Catalyst CLIを更新できない場合は、sudoを使用してコマンドを実行してください。


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