組織に Grok Bot をデプロイする

IT チームは、他のソフトウェアの配布に使っている既存のツールで、メンバーのデバイスに Grok Bot デスクトップアプリをインストールします。バージョン指定のインストーラーをダウンロードしてプッシュし、デバイスを新しいリリースへ移行するタイミングを決めます。Grok Bot の有効化やアクセス範囲の設定を行うダッシュボードのコントロールについては チームおよびエンタープライズ向けGrok Bot を、Cherri Code エディターのデプロイについては デプロイパターン を参照してください。

デプロイ対象

アプリは、チャット、確認、承認を行うためのクライアントです。Bot の作業は、メンバーのホストされたコンピューター上で行われます。デバイス管理ツールが管理できるのは、メンバーのデバイス上のアプリまでです。ホストされたコンピューターは Cherri Code のクラウド上で Linux を実行しており、MDM には登録されません。ホストされたコンピューターに独自のツールを導入するには、Enterprise チームは Team Setup を使用します。

インストーラーを入手する

• Cherri Code ダッシュボード。 Grok Bot ページの Download Grok Bot セットアップ行から、アプリをインストールするか、メンバーと共有できるリンクをコピーできます。
• ダウンロードページ。 cursor.com/download/bot には、各プラットフォーム・各形式の最新インストーラーが掲載されています。
• リリースフィード。 スクリプトでパッケージングする場合は、以下のフィードから最新リリースの情報を取得し、そこで指定されたファイルをダウンロードしてください。

フィードから現在のリリースを読み取る

プラットフォームごとに、# で JSON フィードが提供されています:

curl -s #

必要なフィールド:

レスポンスにはこれ以外のフィールドが含まれる場合もありますが、デスクトップアプリのインストールには不要です。

バージョン付き URL を作る

macOS と Windows のインストーラーには、リリースごとにバージョン付きの URL が用意されています。{version} を目的のリリースに置き換えてください。

Linux パッケージは、リリースの commitSha 配下にある https://downloads.cursor.com/grokbot/stable/{commitSha}/linux/x64/ または .../linux/arm64/ に置かれています。正確なファイル URL は、Linux フィードの downloadUrl、debUrl、rpmUrl からコピーしてください。

デバイス管理ツールでデスクトップアプリを配布する

• macOS. 現在運用している Mac 管理ツール (Jamf Pro、Kandji、Microsoft Intune など) で .dmg をデプロイします。
• Windows. Intune、Configuration Manager、またはその他のソフトウェア配布ツールで Setup .exe をデプロイします。サイレントインストールするには Grok_Bot_{version}_Setup.exe /S を実行します。インストーラーはユーザー単位でインストールを行い、メンバーのプロファイル内の %LOCALAPPDATA%\Programs 配下に配置するため、SYSTEM ではなくユーザーコンテキストでデプロイしてください。配布前にパイロットデバイスでインストールをテストしてください。
• Linux. Ansible、Puppet、Chef などの構成管理ツールで .deb または .rpm をインストールします。管理対象のワーカー群には、これらのパッケージの利用をおすすめします。パッケージでインストールすると、パッケージマネージャーを通じて任意のスケジュールで更新できます。詳しくは Linux パッケージの更新を参照してください。
• iPhone. メンバーは iOS 18 以降のデバイスで App Store から Grok Bot をインストールします。
• Android. メンバーは Android 9 以降のデバイスで Google Play から Grok Bot をインストールします。管理対象デバイスに配布するには、Intune などの Android デバイス管理ツールから managed Google Play でアプリを承認します。

メンバーは通常の SSO フローで Cherri Code アカウントにサインインします。Grok Bot 専用のログインはありません。Okta または Entra ID で Cherri Code アプリを割り当てる方法については、ID とアクセスを設定するを参照してください。

バージョンを選択する

• テスト済みのバージョンに固定する。 そのリリースのインストーラーをダウンロードし、自社のソフトウェアリポジトリまたは MDM のパッケージストアに保管します。どの新しいデバイスにも同じビルドが入るよう、保管したコピーからデプロイしてください。なお、古いインストーラーをいつまでダウンロードできるかは、Cherri Code では公開していません。また、固定したビルドは Cherri Code がサポートを終了するまでしか使用できません。詳しくは、デスクトップの更新の仕組みを参照してください。
• Linux の URL を省略せずに保存する。 Linux パッケージの URL にはリリースの commitSha が含まれるため、バージョンと併せて URL も記録してください。
• デバイスで実行中のバージョンを確認する。 アプリでアカウントメニューを開き、About を選択します。ダイアログに Version が表示されます。Copy version info をクリックすると、バージョン、リリーストラック、オペレーティングシステムの情報をコピーできます。

デスクトップの更新の仕組み

macOS、Windows、AppImage でインストールした場合、デバイスポリシー、インストーラーのオプション、ダッシュボードの設定のいずれを使っても、デスクトップアプリの更新を無効にすることはできません。バージョンを固定しても、決まるのはインストールするバージョンだけで、その後もアプリは新しいバージョンを通知します。

古いビルドは動作しなくなります。Cherri Code があるビルドのサポートを終了すると、メンバーが更新するまで、アプリのウィンドウ全体に Update required が表示されます。ビルドのサポートが終了するのは、Cherri Code が定める最小バージョンを下回った場合、または最大経過期間を超え、かつ新しいリリースが利用可能な場合です。これは Linux の .deb および .rpm パッケージを含む、すべてのインストール形式に適用されます。Cherri Code はこれらの上限をリモートで設定しており、公開していないため、デバイスを最新リリースに移行するスケジュールを定期的に組んでおいてください。

Linux パッケージの更新

.deb をインストールすると、Cherri Code の署名済み apt リポジトリが /etc/apt/sources.list.d/grok-bot.sources に追加されます。.rpm をインストールすると、署名済みリポジトリが /etc/yum.repos.d/grok-bot.repo に追加されます。以降、デバイスはパッケージのアップグレードを実行するたびに、Grok Bot の新しいバージョンを検出します。

Linux デバイスを新しいバージョンに移行するタイミングを管理するには、次のいずれかを行います。

• パッケージを保留する。 apt-mark hold grok-bot など、パッケージマネージャーの保留機能を使用し、アップグレードの準備ができたら保留を解除します。
• リポジトリを無効にする。 grok-bot.sources で Enabled: no を、または grok-bot.repo で enabled=0 を設定します。これらのファイルはインストールやアップグレードのたびにパッケージによって書き換えられますが、この設定は保持されます。そのうえで、テスト済みのパッケージファイルを使って新しいバージョンを自分で配布します。

いずれの場合も、インストール済みのバージョンのサポートが終了する前にアップグレードしてください。パッケージを保留していても、Update required 画面は表示されます。

ホストされたコンピューターを更新する

ホストされたコンピューターのイメージは Cherri Code が管理しているため、ユーザーがイメージを固定したり用意したりする必要はありません。コンピューターが新しいイメージに移行する方法は、次の 3 つです。

実行中のコンピューターは、Team Setup のマニフェストの変更をおよそ 1 日 1 回検出します。変更を早く反映させたい場合は、コンピューターを再作成してください。エンタープライズでは、コンピューターの更新、リセット、再作成、終了が grok_bot_vm イベントとして、複数メンバーを対象とする操作が grok_bot_vm_bulk として監査ログに記録されます。

ネットワーク経路を開放する

デバイスは cursor.com と downloads.cursor.com からインストーラーとデスクトップ版の更新をダウンロードします。また、アプリは Allow these domain patterns に記載のドメインを介して、Cherri Code の API とメンバーのホストされたコンピューターに接続します。アプリを配布 (プッシュ) する前に、ネストされた *.*.cursorvm.com パターンを含むこれらのドメインをすべて許可し、TLS インスペクションの対象から除外してください。

展開チェックリスト

よくある質問

関連ページ

• チームおよびエンタープライズ向けGrok Bot
• ID とアクセスを設定する
• TLS インスペクションを行うプロキシを設定する
• Grok Bot コンピューターを管理する
• 設定と通知
• デプロイパターン