> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/installation/auto-docker-install/upgrading.md).

# アップグレード

自動Dockerインストールを使ったセルフマネージド型Keeperのアップグレード

### SMKの新バージョンへアップグレードする前にお読みください <a href="#read-before-upgrading-to-new-version-of-smk" id="read-before-upgrading-to-new-version-of-smk"></a>

セルフマネージド型Keeperのアップグレードは、その場で更新する方法ではなく、**計画的なダウンタイムを伴う**作業です。クリーンな移行先のインストールを別に用意し、現在のインストールから取得した検証済みのバックアップをそこにインポートし、結果を検証してから、インバウンドのトラフィックを切り替えます。元のインストールは保護された状態で利用可能なまま残り、新しいインストールで書き込みを許可するまでは、いつでも元に戻せます。

{% hint style="warning" %}
アップグレードの前に、Keeperサポートに連絡し、現在のバージョンに基づいて、確認済みのアップグレードパスと適切なパッケージを入手してください。
{% endhint %}

### アップデートの手順 <a href="#update-instructions" id="update-instructions"></a>

1. **新しいバンドルを、起動していない別のインストールとして準備**

Keeperから提供された新しいバージョンのバンドルを、現在のインストールとは別のディレクトリに展開します。その新しいディレクトリで、以下を実行します。

```bash
./smk --instance <new-instance> install --no-start
```

これにより、現在稼働中のインストールには触れずに、新しいバージョンが準備されます。名前を付けたインスタンスには、現在のインストールと競合しないよう、専用のバインドアドレス (`SMK_BIND_ADDRESS`) が必要です。

2. **ガイド付きの管理者ウィザードを実行**

通常の対話型のワークフローでは、新しいバンドルのディレクトリで以下を実行します。

```bash
./smk wizard
```

プロンプトで **Upgrade** を選択します。同じメニューからBackupとRestoreも直接選択できます。また、`./smk backup wizard`、`./smk restore wizard`、`./smk upgrade wizard` で、3つのうちのいずれかに直接移動することもできます。

ウィザードは、保護対象の作業を行う前に、選択した移行元と移行先のインストール、使用するバックアップ、パブリックインスタンスのコンテキストを表示します。最新のバックアップがない場合は、まず稼働中のインストールからバックアップを作成するよう提案します。続いて、そのバックアップを新しいインストールにインポートし、結果を検証して、確認後にのみ、パブリックなトラフィックを新しいインストールに切り替えます。切り替え中に、アクティブなセッションが終了する場合があります。

3. **書き込みを有効にして承認する前に確認**

切り替え後、新しいインストールは、書き込みを許可するまで読み取り専用のままです。元のインストールに戻せるのは、この時点までです。書き込みを許可したら、既存のアカウントでボルトと管理コンソールにサインインし、レコードが正しく復号されることを確認します。PAMルーティング層が有効な場合は、PAMセッションが実際に接続できることも確認します。確認できてから初めて、ウィザードでアップグレードを承認します。

### ロールバックの保護 <a href="#rollback-protection" id="rollback-protection"></a>

アップグレードによって元のインストールが削除されることはないため、アップグレードが中断または失敗しても、デプロイメントがオフラインになることはありません。新しいインストールに問題がないと確認できるまで、元のインストールとバックアップを保持してください。以下を確認します。

```bash
./smk upgrade status
./smk cutover status
./smk operations
```

何かを削除したり、やみくもに再試行したりせず、それぞれが報告するリカバリー操作に従ってください。さらにサポートが必要な場合は、[トラブルシューティング](https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/troubleshooting.md)をご参照ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/installation/auto-docker-install/upgrading.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
