古い情報で、記事を上書きしないようにする

更新に_revを添え、先に保存された変更を古い内容で上書きしないことを確かめます。

目次

EmDashのCLIでは、記事の版を示す_revを更新時に添えると、古い情報での上書きを検出できます。誰かが先に記事を直していた場合に、その修正を消してしまうのを防ぐためです。

この実習では、先に1回更新し、わざと古い版のままもう一度更新します。2回目が拒否され、先のタイトルが残れば成功です。

先に用意するもの

写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。

以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。

起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。

ここからのコマンドはすべて weekend-note で実行します。MacならVS Codeのコマンド入力画面またはターミナル、Windowsならコマンドプロンプトです。npx emdash は、この練習サイトに入れたEmDashの操作用プログラムを呼び出します。--url は操作先で、毎回 http://127.0.0.1:4350 と指定します。

この教材の開発サーバーにだけ接続します。自分の会社のサイトへURLを差し替えて試す必要はありません。

JSONから作る下書きを1本用意してください。以下の ARTICLE_ID は、その結果の id へ置き換えます。記事のURL用slugではなく、管理用IDです。大文字の説明用文字列をそのまま実行しないでください。

1. 現在の版を読む

npx emdash content get posts ARTICLE_ID --raw --url http://127.0.0.1:4350 --json

結果の _rev を控えます。以下ではこれを OLD_REV と書きます。--raw は、コマンドの結果を加工せず確認するための指定です。data.title で今のタイトルも見ておきます。

2. 新しいタイトルを先に保存する

VS Codeで exercises/new-title.json を作るか開き、次を保存します。

{
  "title": "先に保存されたタイトル"
}

次の命令の ARTICLE_ID と OLD_REV を、控えた実際の値へ置き換えます。

npx emdash content update posts ARTICLE_ID --rev OLD_REV --file exercises/new-title.json --draft --url http://127.0.0.1:4350 --json

この1回目は成功します。結果には新しい _rev が返りますが、次の実習では、あえて最初に控えた古い値を使います。--draft があるので公開しません。

3. 古い版で更新しようとする

今度は元の原稿ファイルを使います。OLD_REV には、手順1で控えた値を入れたままにします。

npx emdash content update posts ARTICLE_ID --rev OLD_REV --file exercises/draft.json --draft --url http://127.0.0.1:4350 --json

版が一致しないため、更新は拒否されます。この実習では、古い内容で上書きされなければ成功です。--revを外して更新をやり直さず、次の取得コマンドで内容を確認してください。

手順1の content get をもう一度実行し、タイトルが「先に保存されたタイトル」のままか確認します。検証では2回目の更新が拒否され、先の変更が残りました。

実際の作業で競合したら

最新版を読み、相手の変更と自分の変更を見比べます。残す内容をファイルに反映してから、読み直した最新の _rev を指定して更新します。値だけを新しいものに置き換えて、古い原稿をそのまま送ると、相手の変更を消すことになります。

IDが見つからない場合は、別の練習サイトのIDを使っていないかも確認してください。

終了するとき・次回続けるとき

npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。