主要コンセプト

CatalystでWebクライアントアプリケーションをホストする前に、クライアントリソースを適切な形式でアップロードしてください。

ソースファイル形式

Catalystでエラーなくホストするために、Webアプリケーションのクライアントリソースを適切な形式でアップロードする必要があります。

CatalystでWebクライアントアプリケーションをホストするには、標準のプロジェクトディレクトリ構造でWebアプリケーションのソースファイルをアップロードする必要があります。これについては、プロジェクトディレクトリ構造のヘルプページで詳しく説明されています。

Catalystの標準プロジェクトディレクトリ構造の概要は以下のとおりです：

• プロジェクトディレクトリは基本的に2つのフォルダーで構成されます：functionsとclient。_Web Client Hosting_では、clientディレクトリのみをアップロードする必要があります。clientディレクトリには、JavaScript、HTML、CSSファイルなど、アプリケーションのすべてのフロントエンドクライアントファイルを含める必要があります。
  

• clientディレクトリには2つのファイルが必要です：Webアプリのホームページであるindex.htmlファイルと、クライアントリソースの設定情報を含むclient-package.jsonファイルです。その他のフロントエンドのスタイリング、スクリプティング、またはHTMLファイルは、Webアプリの要件に応じて任意です。
  

• client-package.jsonファイルにWebアプリの名前を指定する必要があります。これがアプリケーションの最終的な名前になります。名前を設定してアプリケーションをホストした後は、変更してはいけません。

• index.htmlファイルの名前を変更した場合、またはWebアプリケーションのホームページとして別のファイルを使用する場合は、client-package.jsonファイルに必要な変更を加える必要があります。

上記のすべてのガイドラインに従った後、Catalystコンソールからwebアプリケーションをホストできます。標準ディレクトリ構造との不一致があると、アプリケーションのホスティングでエラーが発生する可能性があります。

デフォルトWebアプリケーションURL

アプリケーションのデフォルトURLは、ホスト後にコンソールの_Web Client Hosting_または環境設定セクションから取得できます。

デフォルトアプリケーションURLは、アプリケーションをホストすると開発環境用に生成されます。アプリケーションを本番環境にデプロイすると、本番環境URLが生成されます。

開発環境と本番環境のURLは形式がわずかに異なります。両方のURLには以下が含まれます：

• Project Domain Name: _Web Client Hosting_でホストする際にプロジェクトに生成される一意のドメイン名。例：shipmenttracking-57673975。
• Application Domain: ホストするすべてのCatalystアプリケーションのドメインで、’catalystserverless.com‘です。

ただし、開発環境アプリケーションURLには環境タイプも含まれ、その値はdevelopmentです。例：’https://shipmenttracking-57673975.development.catalystserverless.com’。

本番環境URLには環境タイプは指定されません。つまり、本番環境URLは’https://shipmenttracking-57673975.development.catalystserverless.com‘となります。

はじめにで述べたように、ドメインをCatalystにマッピングして、そのURLを代わりに使用することもできます。

アプリケーションバージョン管理

Catalystではアプリケーションのバージョン管理を簡単に行えます。client-package.json設定ファイルには、Webクライアントのバージョン情報が含まれています。

client-package.jsonファイルにバージョン情報を提供する際は、以下のガイドラインに従う必要があります：

1. versionフィールドに小数形式でアプリケーションのバージョン番号を指定する必要があります。versionは、JSONファイル作成時にデフォルトで'1.0.0’として指定されます。
2. Webアプリの後続の更新ごとに、次のバージョンを示すためにJSONファイルのバージョン番号を増分的に変更する必要があります。
3. Webアプリがホストされた後は、バージョン番号を減らしてはいけません。エラーが発生します。
4. Webアプリを変更して本番環境に変更をデプロイする場合、同じバージョン番号を保持してはいけません。Webアプリのバージョンを増分的に更新する必要があります。
5. 現在ライブのバージョンよりも低いバージョンのWebアプリを削除した場合、減分バージョンをデプロイできないため、そのバージョンを置き換えることはできません。ただし、現在ライブのバージョンよりも高いバージョンのWebアプリを削除した場合は、削除されたバージョンと同じバージョン番号でアプリの別のインスタンスをデプロイできます。

Webアプリのバージョン情報は、_Web Client Hosting_の_App Version History_セクションに表示されます。