LCP.jsonによる設定
Liferay Cloud 環境内の各サービスには、サービスを構成するために使用できる LCP.json ファイルがあります。 サービスID、メモリ、CPU数、環境変数、ボリュームなどのプロパティを設定できます。
この表は、 LCP.json に追加できるプロパティの一覧と説明です。
| 項目 | 種類 | デフォルト値 | 説明 |
|---|---|---|---|
id | 文字列 | ランダム | サービスID |
image | 文字列 | "" | Docker Hub のサービスイメージ |
env | オブジェクト | 未分類 | 環境変数 |
loadBalancer | オブジェクト | {} | 公開ポートとドメインの宣言 |
cpu | 数字 | 1 | CPUの数 |
scale | 数字 | 1 | インスタンスの開始数 |
memory | 数字 | 512 | メモリ容量（MB） |
volumes | オブジェクト | 未分類 | データを永続化するためのパス |
readinessProbe | オブジェクト | { "timeoutSeconds": 5 } | サービス準備状況チェック |
livenessProbe | オブジェクト | { "timeoutSeconds": 5 } | サービス稼働状況の確認 |
dependencies | 配列 | [] | 依存関係の展開順序 |
kind | 文字列 | Deployment | デプロイメントの種類（例：DeploymentまたはStatefulSet） |
strategy | オブジェクト | { "type": "RollingUpdate" } | デプロイ戦略（RollingUpdateやRecreateなど） |
ports | 配列 | [] | ポートとプロトコルの宣言 |
environments | オブジェクト | {} | 環境固有の設定 |
deploy | ブール値 | true | 当該サービスが指定された環境に展開されているかどうか。 このプロパティは 環境内の プロパティ内でのみ使用し、ルートレベルでは使用しないでください。 サンプルファイル LCP.json を参照してください。 |
autoscale | オブジェクト | { "cpu": 80, "memory": 80 } | オートスケーリングでのCPUおよびメモリの目標平均使用率。 自動スケーリングとの連携方法の詳細については、 自動スケーリング を参照してください。 |
使用量
すべてのプロパティを使用する LCP.json ファイルの例を以下に示します。
{
"id": "myservice",
"image": "liferaycloud/example",
"env": {
"DB_USER": "root",
"DB_PASSWORD": "pass123"
},
"loadBalancer": {
"cdn": true,
"targetPort": 3000,
"customDomains": ["example.com"],
"ssl": {
"key": "...",
"crt": "..."
}
},
"cpu": 2,
"scale": 2,
"memory": 2048,
"volumes": {
"storage": "/opt/storage"
},
"livenessProbe": {
"timeoutSeconds": 5,
"httpGet": {
"path": "/status",
"port": 3000
},
"initialDelaySeconds": 40,
"periodSeconds": 5,
"successThreshold": 1
},
"readinessProbe": {
"timeoutSeconds": 5,
"exec": {
"command": ["cat", "/tmp/healthy"]
},
"initialDelaySeconds": 40,
"periodSeconds": 5
},
"dependencies": ["service1", "service2"],
"kind": "StatefulSet",
"strategy": {
"type": "RollingUpdate"
},
"ports": [
{
"port": 3400,
"targetPort": 7000,
"protocol": "TCP"
},
{
"port": 9000,
"targetPort": 8000,
"protocol": "TCP",
"external": true
}
],
"environments": {
"prd": {
"memory": 4096,
"cpu": 6
},
"dev": {
"deploy": false
}
},
"autoscale": {
"cpu": 90,
"memory": 90
}
}
環境 構成
環境 構成では、 LCP.json 構成に対する環境固有のオーバーライドが可能です。
例えば、CI サービスは インフラストラクチャ 環境にのみデプロイされるべきなので、この 環境 構成は、"deploy": false）の動作を、特に インフラストラクチャ 環境に対して上書きします。
{
"id": "ci",
"memory": 8192,
"cpu": 4,
"deploy": false,
"environments": {
"infra": {
"deploy": true
}
}
}
JSONオブジェクトのオーバーライド
JSON オブジェクト構成 ( loadBalancer 構成など) の場合、環境ごとにオーバーライドしたい特定のフィールドのみを指定してください。 その他のフィールドは、デフォルトでは既存の設定から継承されます。
この例では、 環境 の設定により、 dev 環境の CDN が無効になりますが、すべての環境のターゲット ポート 80 は維持されます。
{
"id": "webserver",
"memory": 512,
"cpu": 2,
"loadBalancer": {
"targetPort": 80,
"cdn": true
},
"environments": {
"dev": {
"loadBalancer": {
"cdn": false
}
}
}
}
JSON配列のオーバーライド
JSON オブジェクトとは異なり、 環境 構成で JSON 配列をオーバーライドする場合は、オーバーライドで配列全体を定義する必要があります。 配列に含めなかった要素は、環境固有の結果には含まれません。
この例では、 ports 配列をオーバーライドし、 environments 構成で、 uat 環境を 1 つのポートのみで構成します (ただし、他のすべての環境では 2 つのポートを使用します)。
{
"id": "database",
"memory": 1024,
"cpu": 2,
"ports": [
{
"port": 3306,
"external": false
},
{
"port": 3000,
"external": false
}
],
"environments": {
"uat": {
"ports": [
{
"port": 3306,
"external": true
}
]
}
}
}
ウェブサーバーアクセスログ
Liferay 2025.Q4+
LCP_WEBSERVER_NGINX_ACCESS_LOG_MODE 環境変数を LCP.json に設定することで、Web サーバーがクラウド コンソールに転送する NGINX アクセス ログ データの量を制御します。 この設定は、ウェブサーバーサービスにのみ適用されます。
サポートされている値:
-
オフ(デフォルト)アクセスログメッセージをクラウドコンソールに転送しません。 通常動作時はこのモードを使用してください。
-
errorエラー関連のログメッセージのみを転送します。 ウェブサーバーの問題調査を行う際の最初のステップとして、このモードを使用してください。
-
allすべてのアクセスログメッセージを転送します。
エラーが十分な情報を提供しない場合にのみ、このモードを使用してください。
次の例では、Web サーバーの問題を調査するために、 LCP_WEBSERVER_NGINX_ACCESS_LOG_MODE を error に設定します。
{
"id": "webserver",
"env": {
"LCP_WEBSERVER_NGINX_ACCESS_LOG_MODE": "error"
}
}
トラブルシューティング後、通常動作時のログ出力を減らすために、値を から にリセットしてください。