Liferay Cloudのサービスアップデート
2021.12.1のサービスアップデートには、CIサービスが含まれています。
liferay/dxp ドッカーイメージタグ
liferay/dxp ドッカーイメージは、イメージに関連する liferay のバージョン、パッチレベル、およびドッカースクリプトに関する情報を提供します。 Dockerhubにあるliferay/dxpのタグは以下のような形式になっています。
liferay/dxp:{Liferay.DXP.Version}-{Patching-Level}-d{Docker.Script.Version}-{Timestamp}
liferay/dxp:7.2.10-dxp-11-d1.5.4-20210310143709
あなたのプロジェクトに利用する liferay/dxp のベースイメージを選択する際には、Docker タグ全体を考慮し、あなたの環境に適用する前に、あなたのパッチレベルに応じたリリースノートを必ずチェックしてください。 DXP リリースノート
docker イメージはプラットフォーム内でキャッシュされるため、常に末尾に完全なタイムスタンプを持つタグを利用してください。 これらはスナップショットであり、常に公開されている画像と同じものが得られます。 タイムスタンプのないDockerタグはローリングタグとみなされるため、使用しないでください。
CIサービスにおける非推奨の環境変数
以下の環境変数は使用しないようにします。 これらはサポート対象外とみなされ、機能しなくなる可能性があります。 代替が存在する場合は指定される。
DEPLOY_BRANCH -> replaced by LCP_CI_DEPLOY_BRANCH
DEPLOY_TARGET -> replaced by LCP_CI_DEPLOY_TARGET
GITHUB_BRANCH_FILTER_EXCLUDE -> replaced by LCP_CI_SCM_BRANCH_FILTER_EXCLUDE
GITHUB_BRANCH_FILTER_INCLUDE -> replaced by LCP_CI_SCM_BRANCH_FILTER_INCLUDE
GITHUB_REPOSITORY -> split into two LCP_CI_SCM_REPOSITORY_OWNER and LCP_CI_SCM_REPOSITORY_NAME
GITHUB_TOKEN -> replaced by LCP_CI_SCM_TOKEN
JENKINS_CUSTOMER_PASSWORD -> replaced by project secret
JENKINS_CUSTOMER_USER_NAME -> replaced by project secret
JENKINS_EMAIL_NOTIFICATIONS_FROM -> LCP_CI_EMAIL_NOTIFICATIONS_FROM
JENKINS_LCP_CLI_PASSWORD -> replaced by project secret
JENKINS_LCP_CLI_USER_NAME -> replaced by project secret
注:古いプロジェクトでは、JENKINS_LCP_PASSWORDとJENKINS_LCP_CLI_USER_NAMEに使用する認証情報をローテーションするためにDXP Cloudサポートが必要な場合があります。
CIとSCMのトークン
CIサービスは、便宜上、各gitプロバイダのgit webフックを管理するように設定されています。 残念ながら、これはセキュリティと使いやすさの間の利益相反につながるものでした。 git web フックを管理するために必要な権限は、通常、プロジェクトで推奨される権限よりも高いレベルの権限です。
セキュリティの問題を解決するために、CIサービスでは、Webフックを管理するための設定を自動的にオフにできるようになりました。 これにより、LCP_CI_SCM_TOKENにはるかに低いパーミッションを割り当てることができるようになります。
後方互換性を保つため、以前の設定をそのまま残していますが、CIサービスの環境変数を設定することで簡単にオフにすることができます。
LCP_CI_SCM_MANAGE_HOOKS=false
Liferay Cloud CLI のオプション
Liferay Cloud CLIの機能拡張に伴い、CIサービスでのプロジェクトビルド時に設定した方が有利なオプションがある場合があります。 一部のオプションはすでに利用可能です。 しかし、CIサービスの古いリリースでは、現在特定の環境変数にマッチングされているため、CLI内の新しいオプションを利用することができない。 このギャップを埋めるために、複数のオプションを指定できる、より柔軟な環境変数が新たに用意された。 オプションはサニタイズされ、CIが使用しなければならないオプションの予約リストと照合されます。
LCP_CI_CLI_OPTS="quiet suppress-prompts"
LCP_CI_CLI_LOG_LEVEL
LCP_CI_CLI_USE_EXTERNAL_GIT
LCP_CI_CLI_OPTS="quiet suppress-prompts verbose"
DXP Stack 2021.10.1
サービス名 | 過去のリリース | 現在発売中のもの | Dockerイメージ |
バックアップ |
4.2.2 |
4.2.2 |
liferaycloud/backup:4.2.2 |
ひいんようかいすう |
4.1.0 |
4.2.0 |
liferaycloud/jenkins:2.249.3-4.2.0 |
データベース |
4.2.1 |
4.2.1 |
liferaycloud/database:4.2.1 |
Liferay |
4.2.1 |
4.2.1 |
liferaycloud/liferay-dxp:7.3-4.2.1 liferaycloud/liferay-dxp:7.2-4.2.1 liferaycloud/liferay-dxp:7.1-4.2.1 liferaycloud/liferay-dxp:7.0-4.2.1 |
検索 |
4.1.1 |
4.1.1 |
liferaycloud/elasticsearch:7.9.3-4.1.1 liferaycloud/elasticsearch:6.8.13-4.1.1 liferaycloud/elasticsearch:2.4.6-4.1.1 |
ウェブサーバー |
4.0.6 |
4.0.6 |
liferaycloud/nginx:1.16.1-4.0.6 |
アップデート方法
Liferay Cloud の画像は liferay/LCP.json ファイルに設定されていますが、liferay/dxp の画像は gradle.properties に設定されています。 この変更は、Liferay Cloud CLI を使ったデプロイを容易にするために行われたものです。
liferay/LCP.json ファイルは liferaycloud/liferay-dxp イメージを設定することになります。
"image":"liferaycloud/liferay-dxp:7.3-4.2.1"
liferay/gradle.properties ファイルは liferay/dxp のイメージを設定することになります。
liferay.workspace.docker.image.liferay=liferay/dxp:7.3.10-ga1-d1.5.2-20210301040217
LCP.jsonファイルが更新されたら、変更をGitリポジトリにコミットしてください。
git add . && git commit -m "update dxp cloud stack to 2021.12.1"
これらの変更をリモートリポジトリにプッシュすると、Liferay Cloudにビルドが作成され、デプロイできるようになります。
ログを変更する
サービス名 | サービスバージョン | チケット番号 | 説明 |
ひいんようかいすう |
4.2.0 |
LCD-8545 |
不完全なシャットダウンから存在する可能性のあるロックを起動時にクリアする。 |
LCD-10146 |
webhooksを管理するための環境変数を作成する |
||
LCD-10539 |
ワークスペースのルートにあるlcpフォルダーのみをチェックする。 |
||
LCD-10686 |
環境変数からCLIオプションをパースする |