Amazon Web ServicesでLiferay DXPを実行する
AWS で Liferay DXP をホストする方法は 3 つあります。
-
「プレーン」Helm チャートを使用して Liferay DXP をインストールします。
-
AWS Marketplace から Liferay DXP をインストールします。
-
GovCloud から Liferay DXP をインストールします。
Liferay をインストールしたら、ポータルのプロパティや環境変数などを設定できます。 詳細については、「 AWS での Liferay の設定」を参照してください。
前提条件
すべてのインストール方法では、次のユーティリティがインストールされている必要があります。
-
Helm CLIをインストールします。 (バージョン >=
3.18.6) -
kubectl CLIをインストールします。 (バージョン >=
1.25.2)
GovCloud ユーザーはこれらのインストールをスキップできますが、他のインストール方法ではこれらが必要です。
-
Git CLIをインストールします。 (バージョン >=
2.40.1) -
AWS CLIをインストールします。 (バージョン >=
2.27.25) -
AWS CLI を IAM 認証情報を使用するように設定します。
-
Terraform CLIをインストールします。 (バージョン >=
1.7.5)
AWSにログイン
まず、CLI を使用して AWS にログインします。
-
AWS SDK とそのツールで使用するためにプロファイルをエクスポートします。
export AWS_PROFILE=[profile name] -
AWS にログインします。
aws sso login
Terraform ファイルのクローンを作成する
次に、リポジトリから terraform ファイルをクローンします。
git clone -n --depth=1 --filter=tree:0 https://github.com/liferay/liferay-portal.git liferay-aws-terraform
cd liferay-aws-terraform
git sparse-checkout set --no-cone /cloud/terraform/aws
git checkout
cd cloud/terraform/aws
これで、EKS クラスターとのインターフェースに必要なすべてのファイルが揃いました。 次に、
新しいEKSクラスターを作成する
Terraform CLI を使用して、適切なデフォルト設定で新しい EKS クラスターを作成します。
-
前の手順 (
liferay-aws-terraform/cloud/terraform/aws/) 後のターミナルの作業ディレクトリから、eks/ディレクトリに移動します。 -
次の Terraform コマンドを実行します。
terraform initterraform apply -
terraform outputコマンドの結果を、dependencies/ディレクトリ (liferay-aws-terraform/cloud/terraform/aws/内) のterraform.tfvarsファイルに書き込みます。terraform output > ../dependencies/terraform.tfvars
Liferay を実行するための新しい EKS クラスターを作成しました。
既存の EKS クラスターを使用する
EKS クラスターで使用する依存サービスを作成します。
-
eksディレクトリに移動します。 -
EKS クラスターをローカル kubeconfig に追加します。
aws eks update-kubeconfig \ --name $(terraform output -raw cluster_name) \ --region $(terraform output -raw region) -
kubectl cluster-infoを実行して、正しい EKS クラスターが設定されていることを確認します。 -
KUBE_CONFIG_PATH環境変数を設定してエクスポートします。export KUBE_CONFIG_PATH="${HOME}/.kube/config"
Liferay を実行するように EKS クラスターを設定しました。
AWSマネージドサービスでLiferayの依存関係をプロビジョニングする
ここで、Liferay を実行するために必要な環境を用意します。 設定されているとおり、 依存関係 Terraform モジュールは、RDS PostgreSQL データベース、S3 オブジェクト ストレージ バケット、OpenSearch ドメインとともに、Liferay Helm チャートに必要な 環境変数 を提供する managed-service-details Kubernetes Secret をプロビジョニングします。
-
dependencies/ディレクトリ(liferay-aws-terraform/cloud/terraform/aws/内)に移動します。 -
新しい EKS クラスターを構成した場合は、
KUBE_CONFIG_PATH環境変数がローカルのkubeconfigパスに設定されていることを確認します (既存のクラスターを構成した場合は、上記でこれを行っています)。export KUBE_CONFIG_PATH="${HOME}/.kube/config" -
次の Terraform コマンドを実行します。
terraform initterraform apply -
Terraform によって生成された AWS サービスアカウントロールの ARNを設定してエクスポートします。
export AWS_SA_ROLE_ARN=$(terraform output -raw liferay_sa_role)
素晴らしい。 Liferay を起動する準備がほぼ整いました。
次に、Liferay のインストール方法を選択します。