---
title: "プロジェクトのインポート"
url: https://docs.catalyst.zoho.com/ja/cli/v1/export-and-import-projects/import-project/
description: "Catalystでは、プロジェクトをその設定とコードを含めてZIPファイルとしてエクスポートし、ZIPファイルを任意の新しいプロジェクトにインポートできます。"
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
---

# プロジェクトのインポート

### はじめに

プロジェクトのインポートオプションを使用すると、新しいCatalystプロジェクトをインポートできます。Catalystは、ソースZIPファイルに基づいてプロジェクトを作成し設定します。project-template JSONで指定された定義に基づいて各コンポーネントを設定し、FunctionsとClientコードがプロジェクトに入力されます。

はじめにで述べたように、プロジェクトを2つの異なる方法でインポートできます：

* **IaCインポート:** IaCインポートコマンドを実行すると、リモートコンソールにのみプロジェクトがインポートされます。ソースZIPファイルに基づいて、コンソールに新しいプロジェクトが作成され設定されます。ローカルディレクトリにこのプロジェクトは見つかりません。
* **初期化によるインポート:** CLIから[新しいプロジェクトを初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/introduction/)する際にプロジェクトをインポートすることもできます。

これにより、プロジェクト初期化と同じアクションが実行されます。つまり、プロジェクトはCatalystリモートコンソールとローカル環境の両方にインポートされます。ZIPファイルに基づいて、コンソールに新しいプロジェクトが作成され設定されます。project-template JSONファイル、FunctionsおよびClientコードはローカルディレクトリでも利用できるようになります。

インポート操作のその他のすべての機能は、両方のケースで同じです。

覚えておくべき重要なポイント：

* プロジェクトの定義、FunctionsおよびClientコードを含むソースZIPファイルは、前述のとおり、インポートするために[標準形式](https://docs.catalyst.zoho.com/ja/cli/v1/export-and-import-projects/export-import-zip-file/)である必要があります。
* project-template JSONファイルは、ZIPファイルのルートに存在する必要があります。このファイルなしではプロジェクトをインポートできません。`functions`または`client`ディレクトリ、または
[catalyst.json](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/)
設定ファイルは必須ではありません。
* ` [catalyst iac:pack](https://docs.catalyst.zoho.com/ja/cli/v1/export-and-import-projects/generate-zip-file/) `コマンドを使用して、既存のCatalystプロジェクトディレクトリをパックし、インポート対応のZIPファイルをいつでも生成できます。

> **注意:** プロジェクトを本番環境に直接インポートすることはできません。

### IaCインポート

1. IaCインポート方式で新しいプロジェクトをインポートするには、Catalystプロジェクト用の新しいディレクトリを作成して移動し、ターミナルでそのディレクトリから次のコマンドを実行します：

```sh
 catalyst iac:import 
```

2. 新しいプロジェクトの名前を入力し、**Enter**を押します。
 ![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_1.webp)

3. Catalystはコマンドを実行したディレクトリのZIPファイルを確認し、利用可能なZIPファイルからプロジェクトソースとして選択するよう求めます。
 ![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_2.webp)

    ディレクトリにZIPファイルが存在しない場合は、インポートするソースZIPファイルのパスを指定できます。![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_3.webp)

4. CLIはユーザーログインセッションを確認するためにブラウザウィンドウにリダイレクトし、インポートジョブが開始されます。ブラウザウィンドウを閉じてターミナルに戻ることができます。
 ![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_4.webp)

    Catalystはインポート操作に一意のジョブIDを割り当てます。この**ジョブID**を使用して、いつでもジョブの[ステータスを確認](https://docs.catalyst.zoho.com/ja/cli/v1/export-and-import-projects/export-import-job-status/)できます。

    ![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_5.webp)

インポートジョブが完了すると、CLIはそのステータスを表示します。インポートが成功すると、ZIPファイルに基づいてコンポーネント、Functions、Clientが設定された新しいプロジェクトがCatalystリモートコンソールに作成されます。

![Import Project in CLI](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_imported.webp)

いつでもコンソールからローカル環境に[リソースをプル](https://docs.catalyst.zoho.com/ja/cli/v1/pull-resources/introduction/)して、ローカル環境にプロジェクトを取得できます。プロジェクトのプルでは、Functions、Client、API Gatewayルールのみが取得されます。コンポーネントの設定は取得されません。

### プロジェクトインポートオプション

#### \--name

 プロジェクトのインポート時に、`-\\-name`オプションを使用してインポートコマンドでプロジェクト名を直接指定できます：

```sh
 catalyst iac:import --name <project_name> 
```

インポートジョブで作成されるプロジェクトの名前を`-\\-name`オプションで指定します。CLIは、上記のとおり、ディレクトリ内のZIPファイルの選択またはソースファイルへのパスの入力を求めます。

### 初期化によるインポート

1. プロジェクト初期化中にプロジェクトをインポートするには、プロジェクト用に作成した新しいディレクトリから[プロジェクト初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-new-project/)コマンドを実行します：

```sh
 catalyst init 
```

2. ディレクトリに関連付けるプロジェクトのリストから「**Import an existing project**」を選択します。
 ![Import Project through init](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_init_1.webp)

3. プロジェクトの名前を入力し、[IaCプロジェクトインポートセクション](https://docs.catalyst.zoho.com/ja/cli/v1/export-and-import-projects/import-project/#iac-import)で説明したように、ソースZIPファイルを選択するかパスを指定してインポートします。プロセスは同じです。
 ![Import Project through init](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_init_2.webp)

    Catalystはインポート操作の開始後に一意の**ジョブID**を割り当てます。インポートジョブが完了すると、リモートコンソールとローカルディレクトリの両方にプロジェクトが作成され設定されます。![Import Project through init](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_import_init_3.webp)

これはローカルディレクトリにプロジェクトをインポートするため、プロジェクトの詳細を含む` [catalyst.json](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/catalyst-json/) `および`.catalystrc`設定ファイルが作成されます。ZIPファイルに含まれていた場合、プロジェクトディレクトリには`functions`および`client`ディレクトリ、およびproject-template JSONファイルも含まれます。

![Import Project through init](https://catalyst-docs-development.zohostratus.in/images/cli/export-and-import-projects/catalyst_cli_iac_imported_init.webp)