> 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/keeper-connection-manager/jp/pre-release-testing.md).

# プレリリース試験

## 概要

KCMコンテナの早期アクセスを利用するお客様は、以下の手順に従ってください。

{% hint style="warning" %}
プレリリース試験は、必ず本番以外の環境で実施してください
{% endhint %}

### 1. アクセスを申請する

Keeperチームに連絡してアクセスを申請し、Docker Hubのユーザー名を伝えてください。読み取り専用でプレリリースコンテナにアクセスできるBeta Testersチームへ追加します。あわせて、必要な設定を読み込む最新の `kcm-setup.run` ファイルも個別にお渡しします。

### 2. DockerHubにログインする

Keeperのプレリリースリポジトリへの参加招待を承諾したら、<https://hub.docker.com> にアクセスし、**\[Settings]** (設定) > **\[Security]** (セキュリティ) で **\[New Access Token]** (新しいアクセストークン) をクリックし、マシン用の個人用アクセストークンを作成します。

生成されたトークンを使用して、マシンからDockerにログインします。

```
docker login --username YOUR_USERNAME
```

*パスワードの入力を求められたら、パスワードではなく個人用アクセストークンを入力します。*

### 3. 最新のkcm-setup.runを入手する

Keeperから最新の `kcm-setup.run` ファイルを受け取ります。このファイルをサーバーへコピーし、実行権限を付与します。

```
chmod +x kcm-setup.run
```

### 4. コンテナをインストールする

新規インストールか既存インストールかに応じて、以下のセクションに従ってください。

* [インストール - 新規マシン](#installation-new-machine)
* [インストール - 既存マシン](#installation-existing-machine)

## インストール - 新規マシン <a href="#installation-new-machine" id="installation-new-machine"></a>

#### 新規マシンのセットアップ

以下を入力します。

```
export KCM_SETUP_IMAGE_PATTERN="keepersecurityinc/%s-dev"
sudo -E ./kcm-setup.run
```

ライセンスキーの入力を求められたら、Keeperサポートチームから受け取ったキーを入力します。

## インストール - 既存マシン <a href="#installation-existing-machine" id="installation-existing-machine"></a>

{% hint style="warning" %}
これらの変更を行う前に、必ず `docker-compose.yml` ファイルをバックアップし、マシンのスナップショットを取得し、データベースをバックアップしてください。
{% endhint %}

`docker-compose.yml` ファイル (通常は `/etc/kcm-setup/docker-compose.yml`) を更新し、以下のとおりイメージを置き換えます。

* guacdイメージに、下記のとおり `shm_size` および `security_opt` セクションを追加
* guacdイメージを `keepersecurityinc/guacd-dev` に置き換え
* MySQLの場合、dbイメージを `keepersecurityinc/guacamole-db-mysql-dev` に置き換え
* PostgreSQLの場合、dbイメージを `keepersecurityinc/guacamole-db-postgres-dev` に置き換え
* guacamoleイメージを `keepersecurityinc/guacamole-dev` に置き換え
* sslイメージを `keepersecurityinc/guacamole-ssl-nginx-dev` に置き換え
* `KCM_LICENSE` にKeeperコネクションマネージャーのライセンスキーが設定されていることを確認

以下は、イメージ置き換えの例です。

```
version: "3"
services:

    guacd:
        image: keepersecurityinc/guacd-dev
        restart: unless-stopped
        shm_size: 2007372k
        security_opt:
            - "seccomp:/etc/kcm-setup/guacd-docker-seccomp.json"

...
 
     db:
        image: keepersecurityinc/guacamole-db-mysql-dev
...

     guacamole:
        image: keepersecurityinc/guacamole-dev
        restart: unless-stopped
        ...
        environment:
            KCM_LICENSE: "XXXXXXXXXXXXXX"

...
    ssl:
        image: keepersecurityinc/guacamole-ssl-nginx-dev
```

上記のとおり `docker-compose.yml` ファイルを更新したら、以下のコマンドでコンテナを更新します。

{% code overflow="wrap" %}

```
export KCM_SETUP_IMAGE_PATTERN="keepersecurityinc/%s-dev"

sudo docker exec kcm-guacd-1 cat /opt/keeper/share/guacd/docker-seccomp.json > guacd-docker-seccomp.json
sudo mv guacd-docker-seccomp.json /etc/kcm-setup/

sudo -E ./kcm-setup.run stop
sudo -E ./kcm-setup.run upgrade
```

{% endcode %}

これでプレビュービルドが取得され、サービスが再起動されます。

### 以降の更新

新しいビルドが公開されたら、必ず以下のコマンドで更新してください (`-E` は正しいコンテナを読み込むようスクリプトに指示するため重要です)。

```
export KCM_SETUP_IMAGE_PATTERN="keepersecurityinc/%s-dev"
sudo -E ./kcm-setup.run stop
sudo -E ./kcm-setup.run upgrade
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.keeper.io/keeper-connection-manager/jp/pre-release-testing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.