プレリリース試験

Keeperコネクションマネージャーコンテナのプレリリース試験の手順

概要

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

プレリリース試験は、必ず本番以外の環境で実施してください

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. コンテナをインストールする

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

• インストール - 新規マシン
• インストール - 既存マシン

インストール - 新規マシン

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

以下を入力します。

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

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

インストール - 既存マシン

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

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 ファイルを更新したら、以下のコマンドでコンテナを更新します。

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

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

以降の更新

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

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