Configuring the Cloud Network
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

ロードバランサー

Ingressロードバランサーは、お客様の環境のサービスをインターネットからアクセス可能にします。これはTLS 1.2または1.3を使用してサービスへのHTTP(S)接続をプロキシし、各ロードバランサーにはカスタムドメインを設定するために使用できる静的IPアドレスがあります。

カスタムドメインを使用して環境のロードバランサーを構成できます。

専用のロードバランサーを使用すると、ポート設定、カスタムSSL証明書、CDNなどの拡張機能が無数に提供されます。これらの機能は、サービスの LCP.json ファイルで設定できます:

{
  "id": "webserver",
  "loadBalancer": {
    "cdn": true,
    "targetPort": 80,
    "certs": [
        {
            "customDomains": ["acme.liferay.cloud"],
            "key": "...",
            "crt": "..."
        }
    ]
  }
}

CDN

Liferayのコンテンツ配信ネットワーク(CDN)は、Liferay Cloudの組み込み機能です。クライアントとオリジンサーバー間のプロキシとして機能し、バックエンドサーバー(インスタンス)にコンテンツを送信する代わりに、ユーザーに近い拠点(POP)からコンテンツをキャッシュして配信します。

キャッシュ可能なコンテンツに対するDDoS攻撃が発生した場合、リクエストはオリジンサーバーではなくグローバルに分散したPOPに送信されるため、攻撃を吸収するためのより多くの場所が提供されます。また、グローバルな静的コンテンツをキャッシュすることで、配信速度を大幅に向上させることができます。

デフォルトでは、dev環境を除くすべての環境でCDNが有効になっています。 loadbalancerオブジェクト内のcdnの値を設定することで、あるサービス(その LCP.jsonファイル)に対してCDNを有効または無効にすることが可能です。

{
    "loadBalancer": {
        "cdn": true
    }
}

CDNのステータスは[Network]ページに表示されます。

CDNキャッシュのクリア

CDNは、静的コンテンツをユーザーに配信する際のレイテンシを減らすことでパフォーマンスを向上させます。しかし、キャッシュが更新される前に、コンテンツの有効性が失われた状態でユーザーに配信されてしまうことがあります。

CDNキャッシュをクリアして強制的にコンテンツを再取得する必要がある場合、Liferay Cloudコンソールから手動でクリアすることができます。

  1. Liferay Cloudコンソールにログインし、該当する環境に移動します。

  2. 左側のメニューから「ネットワーク」をクリックしてください。

  3. CDNセクションで、 [CDN キャッシュをクリア] をクリックします…

    ご使用の環境の[Network]ページで[Clear CDN Cache]ボタンをクリックします。

  4. [Clear CDN cache]ページで、キャッシュのクリアにともなう影響を理解し、CDNを有効にしたすべてのサービスに適用されるということを理解したら、全てのチェックボックスを選択します。

    [ Clear CDN cache]のページ。

  5. 「キャッシュクリアをリクエスト」をクリックしてください。

ボタンをクリックすると、キャッシュをクリアするためのリクエストが送信されます。キャッシュがクリアされるまで最大30分かかります。

警告

CDNキャッシュを頻繁にクリアしすぎると、サーバーのパフォーマンスに悪影響を与える可能性があります。なぜなら、キャッシュが本来処理するはずだったサービスへのリクエストが、一時的に急増する可能性があるからです。この影響を軽減するため、キャッシュのクリアは例外的な状況に限定してください。

Liferay CDN

Liferay CDNは、Fastlyを基盤として構築されたLiferayのコンテンツ配信ネットワークです。これは、 LCP.jsonで設定するCDNを置き換えるもので、代わりにFastlyで設定されます。 Liferay CDNにアクセスできない環境では、 LCP.json設定を使用します。 Liferay CDNはカスタムドメインを必要とします。Liferayが提供するドメインのみで配信されるサイトには、CDNキャッシュは適用されません。

Liferay CDNには2つのプランがあります。

Liferay CDN:エッジキャッシングとキャッシュパージ、TLS証明書の自動更新、セキュリティヘッダー、および画像最適化を提供します。画像最適化は、リクエスト総数の10%までの画像リクエストに対して料金に含まれており、それ以上の画像リクエストには追加料金が発生する場合があります。

Liferay CDN Plus: Liferay CDNのすべての機能に加え、セキュリティ機能(エッジWebアプリケーションファイアウォール、DDoS攻撃対策、ボット管理、API保護)が追加されます。 Liferay CDNが必要であり、単体では利用できません。

デプロイメント含まれるFastlyアカウントへのアクセス
Liferay PaaSLiferay CDNはい
Liferay SaaSLiferay CDN Plusいいえ
Liferay セルフホストどちらの提供もなし。 Liferay CDNはアドオンとして利用可能です。アドオン付き

サブスクリプションには、Liferay CDN または Liferay CDN と Liferay CDN Plus の両方が含まれます。一部のドメインではLiferay CDN Plusを、他のドメインではLiferay CDNを使用することはできません。

Fastlyアカウントにアクセスすると、キャッシュの消去、トラフィックの表示、CDN設定の変更などが可能です。各新規サービスの開始時に設定される構成については、 「Liferay CDN デフォルト構成」を参照してください。このアカウントには請求情報へのアクセス権限は含まれていません。キャッシュの削除とキャッシュに関するFastlyのドキュメントを参照してください。

デフォルトでは、Liferay CDNはLiferay DXPのみを提供します。クライアント拡張エンドポイントなど、他のエンドポイントをFastly経由で提供するには、Fastlyの設定を調整してください。画像最適化の制限と証明書の制限は同様に適用されます。

Liferay CDNのドメインと証明書

Liferay CDN 上の環境におけるカスタムドメインと TLS 証明書は、Liferay Cloud コンソールではなく Fastly で管理されます。 Liferay SaaSの場合、ドメインまたは証明書の変更を依頼するには、Liferayにサポートチケットを発行してください。

Fastlyは、自動更新されるLet's Encrypt証明書を発行します。デフォルトでは、各環境にはこれらの証明書のうち1つが割り当てられ、その証明書は環境内のすべてのドメインをカバーします。証明書の発行前に、すべてのドメインは検証レコードを整備しておく必要があります。後から追加するドメインは、既存の証明書にダウンタイムなしで統合されます。 Fastlyが管理するドメインと証明書の操作方法については、Fastlyのドキュメントを参照してください。

Fastlyが管理する証明書の代わりに、独自の証明書を環境に使用することもできます。ご自身の証明書は、その環境内のすべてのドメインをカバーしている必要があります。 Liferay PaaSでは、Fastlyに独自の証明書をインストールしてください。 Liferay SaaSの場合は、サポートチケットを通じてLiferayに送信してください。証明書の更新はご自身の責任で行ってください。 Fastlyは、ドメインごとに個別にTLSを有効化します。 1つのFastlyアカウント内で、一方の環境では独自の証明書を使用し、もう一方の環境ではFastlyが管理する証明書を使用することが可能です。ご自身の証明書については、Fastlyのドキュメントを参照してください。

これらの制限はドメインと証明書に適用されます。

  • Fastlyの各アカウントには、Let's Encryptの証明書が5つ含まれています。追加の証明書を購入できます。 Liferay PaaSでは、各プロジェクトに1つのFastlyアカウントが割り当てられるため、5つの証明書はプロジェクト全体に適用されます。
  • 各環境の証明書は、最大100個のドメイン名をカバーします。
  • example.comのようなルートドメインはサポートされていません。Liferay CDN は CNAME レコードを必要としますが、ルートドメインには CNAME レコードを設定できないためです。
  • ワイルドカードは 1 つのレベルをカバーします。 *.example.com shop.example.comをカバーしますが、 a.shop.example.comはカバーしません。
  • ドメインのCAAレコードでLet's Encryptを承認する必要があります。
  • ドメインは一度に1つの環境にしか属することができない。したがって、同じドメインを本番環境と災害復旧環境の両方に存在させることはできない。

ポート

ロードバランサーのサービスエンドポイントがルーティングする内部ポート( targetPort )を設定できます。 Liferay Cloudは、提供するサービスに適したポートを自動的に構成します。

"targetPort": 3000

ロードバランサーには、ポート構成が表示されます。

カスタムSSL

サービスに対してロードバランサー属性を指定すると、次の命名パターンを使用してサービスエンドポイントが追加されます。

  • <SERVICE-NAME>-<PROJECT-NAME>-<ENVIRONMENT-NAME>.lfr.cloud

Liferay Cloudのインフラストラクチャによって作成された.lfr.cloudドメインは、ネットワークページのSSL証明書セクションには表示されないワイルドカード証明書によって保護されています。

コンソールまたはLCP.jsonを通じて追加されたすべてのカスタムドメインについて、Liferay CloudはLet's Encryptに証明書を要求します。この証明書は自動的に更新され、作成したすべてのカスタムドメインをカバーします。

カスタムSSL証明書の追加

また、作成したカスタムドメインを保護するために、独自のSSL証明書を追加することもできます。 Let's Encryptが提供するSSL証明書を使用するか(Liferay Cloudコンソールから追加したカスタムドメインの場合)、 webserverサービスのLCP.jsonファイル内の秘密値を参照して1つ以上のカスタム証明書を定義することができます。証明書が両方の場所に存在する場合、 LCP.jsonファイルで定義されているカスタム証明書が優先されます。

注記

複数のSSL証明書をカスタムドメインにマッピングするには、 webserverサービスのLCP.jsonファイルにcertsプロパティを追加する必要があります。 Liferay Cloudコンソールからカスタムドメインを追加すると、すべてのカスタムドメインが単一の証明書にマッピングされます。

カスタム証明書を作成する際は、Liferay Cloud は、カプセル化境界を含む適切な PEM 形式のBase64エンコードされたキーと証明書のみを受け入れることに注意してください。

  1. 証明書のkeyとcrt値用に、選択した環境に秘密変数を追加してください。

  2. プロジェクトリポジトリのwebserver/LCP.jsonファイルで、 loadbalancerオブジェクトのcertsプロパティを使用して、使用可能な証明書のリストを作成します。 certs配列に、追加したシークレットのキーを参照するkeyとcrt値を持つオブジェクトを追加します。各証明書のkeyとcrt値を、それらがマッピングされるカスタムドメインとまとめてグループ化します。

{
    "loadbalancer": {
        "certs": [
            {
                "customDomains": ["acme.liferay.cloud"],
                "key": "@ssl-key-secret",
                "crt": "@ssl-crt-secret"
            },
            {
                "customDomains": ["acme2.liferay.cloud", "acme3.liferay.cloud"],
                "key": "@ssl-key-secret-2",
                "crt": "@ssl-crt-secret-2"
            }
        ]
    }
}
注記

カスタムドメインのSSL証明書を追加または更新する場合は、Webサーバーサービスにビルドをデプロイして再起動してください。

SSL証明書の生成

鍵を生成する際には、RSA-2048またはECDSA P-256暗号化アルゴリズムを使用し、パスフレーズで保護された鍵は使用しないでください。

カスタム証明書が作成されると、ユーザーはそれらの管理(例えば、新しいカスタムドメインが追加された場合の更新、有効期限切れ時の更新など)に責任を負います。

まだエンコードされていない場合、証明書ファイルとキーファイルの両方に、次のようなテキストが含まれている可能性があります(開始タグと終了タグには、それぞれCERTIFICATEまたはKEY含まれます)。

-----BEGIN CERTIFICATE-----
base64encodedcertificate
-----END CERTIFICATE-----

これらのファイルの内容をエンコードして使用するには、以下の手順を実行してください。

  1. keyとcert両方の内容を格納した新しいファイルを作成します。

    touch originalkeyfile.key
    
    touch originalcertfile.crt
    
  2. keyファイルを開き、開始キータグと終了キータグを含むすべての内容をコピーし、それらを新しく作成したファイル(この例ではoriginalkeyfile.key )にコピーします。ファイルを保存します。

  3. certファイルを開き、開始証明書タグと終了証明書タグを含むすべての内容をコピーし、それらを新しく作成したファイル(この例ではoriginalcertfile.crt )にコピーします。ファイルを保存します。

  4. 以下のコマンドを実行するか(または任意のエンコード方法を使用する)、ファイルをbase64エンコードされた新しいファイルに変換してください。

    openssl base64 -A -in originalkeyfile.key -out base64keyfile.key
    
    openssl base64 -A -in originalcertfile.crt -out base64certfile.crt
    
  5. 新しくエンコードされたkeyファイルとcertファイル(この例では、 base64keyfile.keyとbase64certfile.crt )の内容をすべてコピーし、選択した環境に保存するための秘密変数を2つ追加します。

  6. プロジェクトリポジトリのwebserver/LCP.jsonファイルで、 keyとcrt変数に追加したシークレットのキーを参照してください。

keyとcert値はエンコードされ、Webサーバーの設定で使用できるようになりました。

ヒント

certに複数の値を含めるには、複数の証明書を連結して1つの文字列にし、その結果をbase64でエンコードしてcrtフィールドに表示します。

SSL証明書のステータスを確認する

ネットワークページには、Liferayが提供するSSL証明書と、ユーザーが指定したカスタム証明書が表示されます。各証明書の詳細情報は、表の該当項目をクリックすることで確認できます。証明書を更新する際には、SSL証明書タブを定期的に確認し、証明書が正しく展開されていることを確認することが重要です。証明書の有効期限が切れている場合、有効期限が近づいている場合、または設定に誤りがある場合は、アラートが表示されます。

Liferay Cloudは、カスタムドメインをカバーするSSL証明書のステータスを表示します。

環境変数リファレンス

名前値説明
cdn間違いCDNはデフォルトでは無効になっています。trueに設定することで有効にできますtrue
customDomains["example.com", "www.example.com"]カスタムドメインの名前。複数指定可能。
targetPort3000ロードバランサーのポート番号
key-Base64形式のSSL証明書のキー。これをsslオブジェクト、またはcertsオブジェクト(複数の証明書を一覧表示する場合)にグループ化します。
crt-SSL証明書の署名済み証明書(Base64形式)。これをsslオブジェクト、またはcertsオブジェクト(複数の証明書を一覧表示する場合)にグループ化します。