> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# エアギャップ化された Devin Desktop と CLI を更新する

> エアギャップ化された Devin Desktop と CLI の新バージョンがポータルのダウンロードページにどのように表示されるか、また自動更新を使わずに更新を検証、インストール、確認する方法について説明します。

> [!NOTE]
>
> このドキュメントは Devin の連邦政府向け導入環境を対象としています。[Devin Docs に戻る](/ja/get-started/devin-intro)

エアギャップ化された Desktop と CLI が自動で更新されることはありません。Desktop の build では自動更新が無効化されており、CLI でも `devin update` は無効になっています。更新はすべて新しいバンドルとして提供されます。初回の[インストール](/ja/federal/air-gapped/install)と同じ手順で、ポータルからダウンロードして検証し、各ワークステーションにインストールしてください。このページでは、初回インストールとの違いについて説明します。

***

## 新しいバージョンの反映方法

ポータルの **Install → Air-gapped downloads** ページ ([`windsurf.fedstart.com/install/airgap`](https://windsurf.fedstart.com/install/airgap)) では、常に1つのリリースのみが提供されます。バージョンは **Downloads** 見出しに表示され (例えば `version 1.66.101 (0123abcdef)`) 、各ファイルの SHA-256 チェックサムは、その横にある **Show checksum** コントロールから確認できます。

Cognition がポータルに新しいエアギャップ化されたbuildをリリースすると、ページで提供されるバージョンとチェックサムは新しいものに置き換わります。バージョンピッカーはなく、通知も行われません。リリースを追跡するには、定期メンテナンスの一環として、ダウンロードページに表示されているバージョンをチェックしてください。

## ステップ 1: 実行中のバージョンをチェックする

ワークステーションで、インストール済みの CLI のバージョンとダウンロードページに記載されているバージョンを比較します。

```sh theme={null}
devin --version
```

```text theme={null}
devin-federal <version>+airgap.<sha>
```

`devin --version` を実行すると、リリースバージョンと、build の短縮コミットハッシュが表示されます。Desktop と、それにバンドルされている CLI は同じコミットからビルドされているため、このバージョンは両方に共通です。

## ステップ 2: 新しいバンドルをダウンロードして検証する

新しいバージョンについて、インストールガイドの[ステップ 1](/ja/federal/air-gapped/install#step-1-download-the-bundle-from-the-portal)と[ステップ 2](/ja/federal/air-gapped/install#step-2-verify-the-checksum)の手順を実施します。具体的には、フリート内の各プラットフォーム向けのパッケージをダウンロードし、ポータルページに記載されたチェックサムを控えます。次にファイルをエアギャップ環境へ転送し、インストール前に SHA-256 が一致することを確認します。

チェックサムはリリースごとに変わります。ダウンロード時には必ずポータルページから新しい値を控え、以前のバージョンのチェックサムを使い回さないでください。

## ステップ 3: 既存バージョンに上書きインストールする

まず、ワークステーション上の Desktop を終了し、実行中の `devin` セッションをすべて停止してください。設定、セッション履歴、監査ログ、SSO (シングルサインオン) のログイン情報はアプリケーションの外部に保存されているため ([ディスク上の形式](/ja/federal/air-gapped/on-disk-formats)を参照) 、更新後もそのまま保持されます。

**macOS**

新しい `.dmg` を開き、**Devin - Airgap** を `/Applications` にドラッグします。確認を求められたら、既存のアプリケーションを置き換えてください。その後、[インストールガイドのステップ 3](/ja/federal/air-gapped/install#step-3-install) と同じ手順で署名を検証します。

```sh theme={null}
spctl --assess --type execute --verbose "/Applications/Devin - Airgap.app"
```

```text theme={null}
/Applications/Devin - Airgap.app: accepted
source=Notarized Developer ID
```

**Linux (.deb / .rpm)**

```sh theme={null}
sudo dpkg -i Devin-linux-x64-<new-version>.deb   # Debian/Ubuntu
sudo rpm -U Devin-linux-x64-<new-version>.rpm    # RHEL/Fedora
```

`dpkg -i` は、インストール済みのパッケージをそのままアップグレードします。`rpm` では `rpm -i` ではなく `rpm -U` を使用してください。`rpm -i` ではインストールが拒否されますが、`rpm -U` ならインストール済みのバージョンが置き換えられます。エアギャップ化されたbuild向けの apt / yum リポジトリは提供されていません。

**Linux (.tar.gz)**

既存の展開ディレクトリを別名に退避してから、新しいアーカイブを同じ場所に展開します。こうすることで、ランチャーのパス (`/opt/Devin-linux-x64/bin/devin-airgap`) や、同梱の `devin` バイナリ用に設定した `PATH` をそのまま使用できます。

```sh theme={null}
sudo mv /opt/Devin-linux-x64 /opt/Devin-linux-x64.previous
sudo tar -xzf Devin-linux-x64-<new-version>.tar.gz -C /opt
```

新しいバージョンの動作を確認したら、`/opt/Devin-linux-x64.previous` を削除してください。

**Windows (installer)**

[インストールガイドのステップ 3](/ja/federal/air-gapped/install#step-3-install) と同じ手順で新しいインストーラーの Authenticode 署名を検証し、管理者として実行します。

```powershell theme={null}
Get-AuthenticodeSignature .\DevinSetup-x64-<new-version>.exe | Format-List Status, SignerCertificate
```

エアギャップ化されたbuildには更新 URL がないため、インストール済みの環境をアップグレードするには新しいインストーラーを使用する必要があります。

**Windows (.zip)**

`Devin-win32-x64-<new-version>.zip` を新しいフォルダに展開し、[インストールガイドのステップ 3](/ja/federal/air-gapped/install#step-3-install) と同じ手順で展開した実行ファイルの署名を検証してから、新しいフォルダから Desktop を起動します。

新しいバージョンの動作を確認したら以前のフォルダを削除し、同梱の `devin.exe` 用に設定した `PATH` を更新してください。

`/etc/devin/` (Windows では `C:\ProgramData\Devin\`) にあるライセンスファイル、モデルファイル、認証ファイルはパッケージに含まれないため、更新による影響を受けません。

## ステップ 4: 更新を検証する

更新した各ワークステーションで、通常ユーザーとして次のコマンドを実行します。

```sh theme={null}
devin --version
devin airgap doctor
```

```text theme={null}
devin-federal <new-version>+airgap.<sha>
pass  license                                seat alice@example.gov (account acme), expires 2027-03-01
...
10 check(s): 10 passed, 0 warning(s), 0 failure(s)
```

次に、Desktopを一度起動し、モデルエンドポイントに接続してセッションが開始されることを確認します。

更新時に特に注意すべき失敗は次の2つです。

| 症状 | 原因 | 対処 |
| - | - | - |
| 更新直後に `LIC004` が発生する | 新しいbuildにはローテーション後の公開キーのセットが組み込まれていますが、ライセンスはそのbuildで信頼されなくなったキーで署名されています。 | ポータルから新しいライセンスを発行し、[ライセンスの更新または差し替え](/ja/federal/air-gapped/license#renew-or-replace-a-license)の手順に従ってファイルを置き換えます。[`kid` チェック](/ja/federal/air-gapped/license#check-the-key-id)を実行して確認してください。 |
| 以前は検証を通過していたモデルファイルで `MDL` コードが発生する | 新しいリリースでモデルファイルの検証内容が変更されました。 | `devin models validate` を実行します。診断結果に該当するフィールドとコードが表示されます。[モデルファイル](/ja/federal/air-gapped/models-file)を参照してください。 |

すべての `session_start` 監査レコードには `cli_version` が含まれるため、SIEMで段階的展開の進捗を確認できます。更新済みのワークステーションからのセッションでは、新しいバージョンが記録されます。

## ロールバック

新しいバージョンがフリート全体で検証されるまでは、以前のバージョンのパッケージとチェックサムを保持しておいてください。ロールバックの手順はインストールと同じです。古いパッケージのチェックサムを検証し、新しいバージョンに上書きしてインストールします。RPM システムでは `--oldpackage` を追加してください。このオプションがないと、`rpm -U` は新しいバージョンを古いバージョンで置き換えることを拒否します。

```sh theme={null}
sudo rpm -U --oldpackage Devin-linux-x64-<previous-version>.rpm
```

## リリースノート

エアギャップ化されたbuildのリリースノートは、Devinの他のリリースノートとあわせて[最近の更新](/ja/release-notes/overview)で公開されています。新しいバージョンを展開する前に該当バージョンの項目を読み、特に次の点を確認してください：ディスク上の保存形式や監査ログのスキーマ (`schema_version`の値) の変更、エラーコードの追加・変更、ライセンスの再発行が必要となるライセンスキーのローテーションの有無。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.