失敗した更新を直す.
失敗した更新を仕上げます。ほぼすべての場合、コードは更新済みでデータベースが 未更新、手上げ複写のモジュールが邪魔、依存が欠落のいずれかです。
正しい順序で更新を実行する
- データベースをバックアップします。
- 実行するのは
composer require drupal/dxpr_builderです。リリース固定なら版制約付きで。 - 実行するのは
drush updb -yです (または/update.phpを開きます)。 - 実行するのは
drush crです。 - ビルダーページを1つ開いて保存し直します。
重要: 更新のためにモジュールをアンインストールしないでください。 アンインストールは保存済みテンプレート、プロファイル、設定を削除します。
Composerがエラーを出す
- "Could not find a version of package drupal/dxpr_builder
matching your minimum-stability". 3.xはベータリリース公開です。制約で許可します。
composer require 'drupal/dxpr_builder:^3.0@beta'。 - "Could not find a matching version of package
dxpr/dxpr_builder". drupal.orgのパッケージは
drupal/dxpr_builderです。composer.jsonのdxpr/dxpr_builderをdrupal/dxpr_builderに替え、composer update drupal/dxpr_builderを実行します。 - フォルダーがComposer管理外のためComposerが拒否します。 複写が手上げされています。
modules/contrib/dxpr_builderを 削除してrequireコマンドを再実行します。 - "Disk quota exceeded" or "write failed". 再試行前にサーバーの空き容量を 確保します。
データベース更新が失敗する
- "Unable to install modules key due to missing modules key".
3.xにはKeyモジュールが必要で、更新9020が導入します。Composerでモジュールを
入れていないためコードがありません。
composer require drupal/keyを実行し、drush updb -yを再実行します。 - 名前付き更新フックが失敗します。
drush updb -vvvを実行し、 全エラーをチケットに含めます。 - "module 'dxpr_builder_page' is missing its dependency module
field_group". DXPR Builder Drag and Drop PageサブモジュールにはField Groupが
必要です。
composer require drupal/field_groupを実行し、drush en dxpr_builder_page -yを実行します。
更新後にページが壊れて見える
一部リリースは旧マークアップ (Owlカルーセルやサークルカウンターなど) を
drush updb中のバッチで変換します。失敗分は保留のままです。
- 開くのはDXPR Studio > DXPR Builder > Content items >
Migrations
(
/admin/dxpr_studio/dxpr_builder/migration-status) を開きます。 - 移行がPendingならRun nowをクリックするか、Run all pending migrationsをクリックします。
- 確認するのはReports > Recent log messagesでバッチが飛ばした項目を 確認します。
ComposerがDrupalコアメジャー更新を拒む
DXPR Builder 3.xはDrupal 10.2以降とDrupal 11に対応します。
- 新メジャー対応版についてDXPR Builder、DXPR Theme、DXPR Theme Helperのリリースノートを 確認します。
- Upgrade Statusを実行して未対応パッケージを見ます。
- 固定するのはコアメジャーを
composer.jsonで。制約なしcomposer require drupal/core-recommendedは次のメジャーを誤って引きます。
更新直後にエディターが壊れた
従うのはエディターが表示されないです。そこの上位原因は部分更新後のものと同じです。保留データベース更新、 古いファイル、旧リリースで作った集約キャッシュです。
Glazed Builderから移行する
DXPR Builder 3.xは格納コンテンツのGlazedクラス名をもう変換しません。先に最終2.x リリースへ更新してデータベース更新を実行し、次に3.xへ更新します。 DXPR Builder 1.x・2.xからの移行を ご覧ください。
修正の確認
drush updbが保留更新なしを報告し、drush pm:list --filter=dxprが意図の版を
示し、保存し直したビルダーページがエディターと訪問者で同じに描画します。
次はこちら
DXPR Builderの更新が通常の 更新手順です。