CNE:互換性マトリックス
Cloud Native Experience (CNE) ブートストラップは、AWS Ready および GCP Ready デプロイメント向けに、ここに記載されているコマンドラインツールとクラスタバージョンで動作します。
CNEブートストラップはTerraformのバージョンを検証しますが、他のツールについては存在のみを確認します。互換性のないバージョンの別のツールを使用すると、ブートストラップの開始時ではなく、そのツールの実行時にエラーが発生します。
共有ツール
これらの要件はAWSとGCPで同じです。
| 道具 | 互換性 | メモ |
|---|---|---|
| テラフォーム | >= 1.10.0 | これは、ブートストラップが強制する唯一のバージョンです。 Terraformはすべてのインフラストラクチャをプロビジョニングします。 |
| OpenTofu | サポートされていません | ブートストラップはそれを拒否します。 OpenTofu を参照してください。 |
| kubectl CLI | クラスターのマイナーバージョン1つ以内 | このバージョンはKubernetesのバージョン偏りポリシーに従います。 kubectl を参照してください。 |
| カール | どれでも | ランチャーは、ブートストラップアーカイブをダウンロードする必要があります。 |
| jq | どれでも | ブートストラップスクリプトは、JSONを解析するためにそれを必要とします。 |
| タール | どれでも | ランチャーは、ブートストラップアーカイブを解凍するためにそれを必要とします。 |
| Helm CLI | どれでも | Bootstrapではそれは必要ありません。手作業で海図を検査したり、引き出したりするためにインストールしてください。 |
| Argo Workflows CLI | v4.1.2 | Bootstrapではそれは必要ありません。 Argo Workflowsサーバーのバージョンに合わせて、バックアップ、復元、およびオンラインアクティベーションのワークフロー用にインストールしてください。 |
テラフォーム
AWS ReadyおよびGCP Readyには、Terraform 1.10.0以降が必要です。
AWS Terraformスタックは、 required_version = ">=1.10.0" を宣言します。 GCPスタックは >=1.5.0を宣言していますが、GCPセットアップスクリプトは実行前に1.10.0を強制するため、1.10.0が両方のデプロイメントの実質的な最小バージョンとなります。
CNEのブートストラップはバージョンを2回チェックするため、表示されるエラーはインストール時期によって異なります。ランチャーはバージョン1.5.0未満のインストールを拒否し、プロバイダーセットアップスクリプトはバージョン1.5.0から1.10.0の間のインストールを拒否します。
The installed Terraform version 1.7.5 is older than 1.10.0.
OpenTofu
OpenTofuは、どのバージョンにおいても、どちらのクラウド環境でもサポートされていません。 CNE ブートストラップは terraform 実行ファイルを必要とし、 tofu 実行ファイルを代替として扱わないため、標準の OpenTofu インストールでは存在チェックに失敗します。
The utility terraform is not installed.
terraform を OpenTofu インストールにシンボリックリンクしても、サポートされている構成は生成されません。ブートストラップはバージョン出力がTerraformを識別することを想定しており、OpenTofuのバージョン出力は認識しません。
kubectl
AWS Ready も GCP Ready も Kubernetes バージョンを固定していないため、インストールするための固定の kubectl フロアはありません。 Kubernetes は、API サーバーのマイナー バージョン (古いバージョンでも新しいバージョンでも) 内で kubectl をサポートしています。プロビジョニング後にクラスターのバージョンを確認し、結果からマイナーバージョンが 1 つ以内の kubectl をインストールします。
AWS対応
EKSスタックは、AWSが標準サポートで提供しているクラスターバージョンを照会し、独自のバージョンを固定するのではなく、その中から1つをプロビジョニングします。 AWSがEKSのバージョンを追加または廃止するにつれて、利用可能なバージョンは変更される可能性があります。
| 依存 | 互換性 | 注記 |
|---|---|---|
| Kubernetes (Amazon EKS) | AWSが標準サポート対象としてリストしているバージョンの一つ | スタックはバージョンを固定しません。 |
| AWS CLI | バージョン2 | セットアップ スクリプトは aws sso loginを実行しますが、これは AWS CLI バージョン 1 では提供されていないコマンドです。 |
| PostgreSQL (Amazon RDS) | Liferay互換性マトリックスによると | ブートストラップはそれを外部サービスとしてプロビジョニングします。 |
| OpenSearch(Amazon OpenSearch)またはElasticsearch(ECK) | Liferay互換性マトリックスによると | ブートストラップはそれを外部サービスとしてプロビジョニングします。 |
GCP対応
GKEスタックはクラスターを REGULARリリースチャネル にサブスクライブし、最小バージョンは設定しません。したがって、Googleはクラスターが実行するKubernetesのバージョンと、クラスターのアップグレード時期を制御します。チャネルが提供するバージョンについては、 GKE のバージョン管理 を参照してください。
| 依存 | 互換性 | 注記 |
|---|---|---|
| Kubernetes (GKE) | GKE REGULAR リリース チャネルでサポートされているバージョン | スタックはバージョンを固定しません。 |
| gcloud CLI | > 399.0.0 | ブートストラップでは存在のみを確認しますが、Connectゲートウェイの復旧パスにはこのバージョンが必要です。 |
| GKE gcloud認証プラグイン | 最新 | gcloud CLI の後にインストールして、 kubectl を GKE クラスターで認証します。 |
| PostgreSQL(クラウドSQL) | Liferay互換性マトリックスによると | ブートストラップはそれを外部サービスとしてプロビジョニングします。 |
| Elasticsearch (ECK) | Liferay互換性マトリックスによると | Elasticsearchはクラスター上で動作します。 |
Terraform apply が失敗すると、セットアップ スクリプトは kubectl コンテキストを Connect ゲートウェイ経由で gcloud container fleet memberships get-credentials を使用して復元します。
gcloud CLI のバージョン 399.0.0 以下は、クラスター上に Connect エージェントが存在することを前提としており、より新しいバージョンで登録されたクラスターに対しては失敗する可能性があります。 gcloud CLI のリリースバージョンが 399.0.0 より新しいものを使用するか、 --install-connect-agent を使用してメンバーシップを再登録してください。 Connectゲートウェイの使用 を参照してください。
Liferay DXPとの互換性
データベースと検索エンジンの互換性は、CNEではなくLiferay DXPによって決定されます。サポートされているバージョンについては、 Liferay 互換性マトリックス を参照してください。
チャートがデフォルトでデプロイする Liferay DXP イメージは、 CNE: Helm Values Referenceの イメージ の下に表示されます。