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

Liferayを任意のKubernetes Cluster for Cloud（2025.Q4およびそれ以前のバージョン）で実行する

注

このガイドでは、2025年第4四半期以前から使用されていたKubernetesツールキットのバージョンについて説明します。 2026年第1四半期より、ツールキットは 合理化されたエクスペリエンスに再設計されました。

これらの説明は意図的に一般的な内容になっています。 彼らはあらゆるKubernetes実装上で動作するクラスターをインストールしますが、そのクラスターを本番環境で使用できる状態にするには、追加の作業が必要です。 本番環境を構築するための詳細については、ご利用のクラウドプロバイダーのドキュメントをご確認ください。

始める前に、いくつかの前提条件をインストールしておく必要があります。

この例ではK3Dを使用していますが、Kubernetesクラスタの実装であればどれでも使用できます（例：kind、Docker Desktopなど）。

Kubernetesクラスターを作成する

まず、マシンのポート 80 を内部 k3d ロード バランサーのポート 80 にマッピングし、必要に応じて他のコンテナ イメージをビルドおよびデプロイするためのローカル イメージ レジストリを作成する playground という名前の Kubernetes クラスターを作成します。

  1. 次のコマンドを実行します。

    k3d cluster create playground \
   --port 80:80@loadbalancer \
   --registry-create registry:5000
注

ルートレス Docker を実行している場合は、行 --port 80:80@loadbalancer を変更して、ポート 80 の代わりに利用可能な非特権ポート (> 1024) を使用するようにします。 例えば、

--port 8182:80@loadbalancer

この変更を行うには、選択したポート（上記の例では8182）を使用するように、以下のLiferayポータルプロパティを変更する必要があります。

web.server.http.port=8182

  1. 以下の2つのコマンドを実行して、クラスターが存在することを確認してください。

    kubectl config current-context
kubectl cluster-info

Helmチャート値の設定

  1. 以下の設定で values-custom.yaml ファイルを作成します。

    customInitContainers:
  x-liferay-prewipe-hypersonic:
    containerTemplate: |
      command:
        - bash
        - -c
        - |
          FLAGFILE=/opt/liferay/data/.hypersonic.prewiped
          if [ ! -e "${FLAGFILE}" ]
          then
            rm -rf /opt/liferay/data/hypersonic
          fi
          touch "${FLAGFILE}"
      image: {{ printf "%s:%s" .image.repository (.image.tag | toString) }}
      imagePullPolicy: {{ .image.pullPolicy }}
      name: liferay-prewipe-hypersonic
      volumeMounts:
        - mountPath: /opt
          name: liferay-persistent-volume
image:
  tag: [Your Liferay Version Tag Here]
ingress:
  enabled: true
  rules:
    - host: "*.dxp.localtest.me"
      http:
        paths:
          - backend:
              service:
                name: liferay-default
                port:
                  name: http
            path: /
            pathType: ImplementationSpecific
portalProperties: |
  company.default.virtual.host.name=main.dxp.localtest.me
  company.default.web.id=main.dxp.localtest.me
  include-and-override=portal-developer.properties
  web.server.protocol=http

  2. 上記の [ここにLiferayのバージョンタグを入力] を、 Docker Hub から適切なLiferayタグに置き換えてください。

  3. 非特権ポートを設定した場合は、 portalProperties に以下のプロパティを追加してください。

    web.server.http.port=[port]

    例えば、

    web.server.http.port=8182

これらの値の詳細については、 Liferay Helm 値リファレンス を参照してください。 Helm の値ファイルについて詳しく知りたい場合は、 Helm のドキュメント を参照してください。

上記の構成は、

  • お使いのLiferayイメージのバージョン
  • Liferayサービスをローカルに公開するためのイングレスロードバランサー
  • カスタムLiferayポータルプロパティ
  • 初期化コンテナ を使用して、付属のHSQLデータベースを事前に消去し、カスタム company.default.web.id ポータルプロパティを使用します。

HSQLが構成済みのデータベースであるため、このインスタンスは初期構成のままテスト目的で使用されていることに注意してください。

Liferayを起動する

  1. チャートのURLを格納する環境変数を作成します。

    export CHART_URL=oci://us-central1-docker.pkg.dev/liferay-artifact-registry/liferay-helm-chart/liferay-default

  2. Liferay Helmチャートをクラスターにインストールします。

    helm upgrade liferay "${CHART_URL}" \
--install \
--values values-custom.yaml

Liferayにアクセスする

  1. Liferayワークロードが準備完了かどうかを確認してください。

    kubectl rollout status statefulset liferay-default

  2. Liferayにアクセスするには、ローカルマシンのWebブラウザで http://main.dxp.localtest.me にアクセスしてください。 ウェブサーバーのポートを変更した場合は、ポート番号を追加してください: http://main.dxp.localtest.me:8182。

  3. Liferayの管理者パスワードを取得する：

      kubectl get secret liferay-default \
  --output jsonpath='{.data.LIFERAY_DEFAULT_PERIOD_ADMIN_PERIOD_PASSWORD}' \
  | base64 --decode

  4. Liferayにログインしてください：

    • メールアドレス: test@main.dxp.localtest.me
    • パスワード：[前の手順で取得したパスワード]

Liferay Kubernetesクラスターの「プレイグラウンド」環境をデプロイしました！ より堅牢にする方法については、続きをお読みください。

Capability:
Cloud
DXP Self-Hosted Installation, Maintenance, and Administration
Resource Type:
Official Documentation
Deployment Approach:
Liferay PaaS
Liferay Self-Hosted