はじめに

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

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

• IaCインポート: IaCインポートコマンドを実行すると、リモートコンソールにのみプロジェクトがインポートされます。ソースZIPファイルに基づいて、コンソールに新しいプロジェクトが作成され設定されます。ローカルディレクトリにこのプロジェクトは見つかりません。
• 初期化によるインポート: CLIから新しいプロジェクトを初期化する際にプロジェクトをインポートすることもできます。

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

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

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

• プロジェクトの定義、FunctionsおよびClientコードを含むソースZIPファイルは、前述のとおり、インポートするために標準形式である必要があります。
• project-template JSONファイルは、ZIPファイルのルートに存在する必要があります。このファイルなしではプロジェクトをインポートできません。functionsまたはclientディレクトリ、またはcatalyst.json設定ファイルは必須ではありません。
• catalyst iac:packコマンドを使用して、既存のCatalystプロジェクトディレクトリをパックし、インポート対応のZIPファイルをいつでも生成できます。

IaCインポート

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

2. 新しいプロジェクトの名前を入力し、Enterを押します。
   

3. Catalystはコマンドを実行したディレクトリのZIPファイルを確認し、利用可能なZIPファイルからプロジェクトソースとして選択するよう求めます。
   

   ディレクトリにZIPファイルが存在しない場合は、インポートするソースZIPファイルのパスを指定できます。

4. CLIはユーザーログインセッションを確認するためにブラウザウィンドウにリダイレクトし、インポートジョブが開始されます。ブラウザウィンドウを閉じてターミナルに戻ることができます。
   
   

   Catalystはインポート操作に一意のジョブIDを割り当てます。このジョブIDを使用して、いつでもジョブのステータスを確認できます。

   

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

いつでもコンソールからローカル環境にリソースをプルして、ローカル環境にプロジェクトを取得できます。プロジェクトのプルでは、Functions、Client、API Gatewayルールのみが取得されます。コンポーネントの設定は取得されません。

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

--name

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

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

初期化によるインポート

1. プロジェクト初期化中にプロジェクトをインポートするには、プロジェクト用に作成した新しいディレクトリからプロジェクト初期化コマンドを実行します：

2. ディレクトリに関連付けるプロジェクトのリストから「Import an existing project」を選択します。
   

3. プロジェクトの名前を入力し、IaCプロジェクトインポートセクションで説明したように、ソースZIPファイルを選択するかパスを指定してインポートします。プロセスは同じです。
   

   Catalystはインポート操作の開始後に一意のジョブIDを割り当てます。インポートジョブが完了すると、リモートコンソールとローカルディレクトリの両方にプロジェクトが作成され設定されます。

これはローカルディレクトリにプロジェクトをインポートするため、プロジェクトの詳細を含むcatalyst.jsonおよび.catalystrc設定ファイルが作成されます。ZIPファイルに含まれていた場合、プロジェクトディレクトリにはfunctionsおよびclientディレクトリ、およびproject-template JSONファイルも含まれます。