User Agent

QueryPie Agentをインストールすると、DataGrip、DBeaverのようなSQL Client、iTerm/SecureCRTのようなSSH Client、Lens、k9sのような3rd Partyアプリケーションを使用できます。

エージェントアプリダウンロードおよび実行

1. QueryPieログイン後右上プロフィールをクリックして`Agent Download`ボタンをクリックします。

2. 使用中のPCオペレーティングシステムに合うインストールファイルをダウンロードします。

QueryPie Agent Downloadsポップアップウィンドウの Step 1 で、使用中のPCオペレーティングシステムに合うインストールファイルをダウンロードします。 Step 3 セクションに表示されたQueryPie URLをコピーしておきます。

QueryPie Web > Agent Downloadsポップアップウィンドウ

QueryPie AgentはMac、Windows、Linux OSをサポートします。

3. ダウンロードしたQueryPie Agentインストールプログラムを実行してインストールを完了します。

4. インストールされたQueryPie Agentを実行します。

QueryPie Host入力欄に事前にコピーしておいたQueryPie URLを入力してNextボタンをクリックするとログイン画面にアクセスします。

QueryPie Agentにログイン

1. Agentアプリ内ログイン画面で`Login`ボタンをクリックします。

2. ウェブブラウザが開くと、ログインページで認証情報を入力し、`Continue`ボタンをクリックします。

3. ログインが成功すると下記のようにログイン成功画面が表示されその後Agentに戻ります。

4. Agent開きを明示的に実行して認証情報をAgentに伝達します。

エージェントでデータベース接続

1. Agentアプリ内Databaseタブで権限のあるコネクションの接続情報を確認します。

ログインが正常に完了されるとAgentアプリ内Databaseタブで権限のあるコネクションの接続情報を確認できます。接続するコネクションに割り当てられたPortをクリックすると、該当コネクションのProxy Credentials情報を確認できます。

2. 上記の接続情報を3rd Partyクライアントに入力するとDBコネクション接続が可能です。

エージェントを通じたサーバー接続

ログインが正常に完了されるとAgentアプリ内Serverタブで権限のあるサーバーを確認できます。

1. サーバー役割選択

ユーザープロフィール領域下部のRoleボタンをクリックして希望する役割を選びOKボタンをクリックしてください。Default役割を選択する場合、Workflow > Server Access Request要求により割り当てられたサーバー権限を使用します。

役割が2個以上なら、Agentログイン後Server機能使用のために役割選択をまず完了しなければなりません。

2. Agentでサーバー接続

接続するサーバーを右クリック後Open Connection withメニューを選択して、使用したいターミナルツールを選択します。

その後該当サーバーに接続可能なアカウントが複数あるなら、Account選択窓が開きます。使用したいアカウントを選択し、必要時パスワードを入力した後、OKボタンをクリックしてセッションを開きます。

3. Seamless SSH設定

Seamless SSHとは既存ターミナル使用性をそのまま維持しながらQueryPieを通じてサーバーに接続できる機能です。次の方法で.sshフォルダにconfigファイルを作成して簡単にSeamless SSHを設定できます。

3.1. ターミナルを開き、`.ssh`フォルダに移動します。


$ cd .ssh

3.2. `.ssh`フォルダで`config`ファイルを作成するためviエディターを開きます。


$ vi config

3.3. 下記の内容を入力後、`Esc`と`:wq`を入力して変更事項を保存し、viエディターを終了します。


Host {{Server Name}}
  Hostname {{Server URL}}
  Port {{Server SSH Port}}
  ProxyCommand qpa ssh %r %h %p

configファイル作成時Seamless SSH設定したいサーバーごとにサーバー名、URL、ポートを入力することでサーバーを特定します。サーバー間でURL、ポートが重複しない場合は下記のように入力しても接続できます。


Host *
  ProxyCommand qpa ssh %r %h %p

3.4. 以上で設定が完了します。

Agent > Serverタブで役割を選択すると既存sshコマンドでサーバーに接続できます。


$ ssh deploy@{{Server Name}}

エージェントを通じたKubernetes接続

権限を付与されたユーザーはエージェント実行時現在ポリシーに応じたkubeconfigファイルが自動で受信されます。これを通じてKubernetes Client（kubectl、lens、k9sなど）ツールでKubernetes APIリソースにアクセスできます。

エージェントではアクセス可能なクラスターリストを表示し、各クラスターに適用されたポリシーを確認できます。また設定メニューを通じてkubeconfigファイルの位置を確認し、ファイルのパスを変更できます。

1. Kubernetes役割選択

ユーザープロフィール領域下部のRoleボタンをクリックすると役割選択モーダルが開きます。希望する役割を選びOKボタンをクリックしてください。

役割が2個以上なら、Agentログイン後Kubernetes機能使用のために役割選択をまず完了しなければなりません。

2. Policy照会

選択された役割に応じてアクセス可能なリソースが表示されます。各クラスター右側の🔍ボタンを押すとPolicy Informationポップアップウィンドウが現れ、ここで該当クラスターに適用されたポリシー目録を詳しく確認できます。

3. Kubeconfigパス設定

Agent設定メニューでKubeConfig PathボタンをクリックしてKubeconfigパス設定モーダルを開きます。

Agent > Settings > Configure Kubeconfig Path

Path Configuration : Kubeconfigファイル保存パスをユーザーが指定できます。
- 基本値は$HOME/.kube/querypie-kubeconfigです。
- パスフィールド右側Uploadボタンを押すとローカルファイルパスを指定できるポップアップが現れます。

Where : 右側の🔽ボタンをクリックして希望するフォルダを指定します。
Save As : Kubeconfigファイルの名前を入力します。変更しないと基本値で適用されます。
Command Line : KUBECONFIG環境変数を宣言するためのコマンドラインを提供します。

KUBECONFIG環境変数を初回設定する場合、コマンド行内のデフォルト”${KUBECONFIG}”値を使用前に”${HOME}/.kube/config”に変更しなければなりません。


export KUBECONFIG="${HOME}/.kube/config:${HOME}/.kube/querypie-kubeconfig"

QueryPieで提供されたユーザー指定kubeconfigパスを変更した場合新パスで環境変数を再び宣言しなければなりません。


export KUBECONFIG="${KUBECONFIG}:<user-specified-path>"

より詳細なkubeconfigに対する内容は次のリンクを参照してください。

参考: kubeconfigファイルマージ
参考: KUBECONFIG環境変数設定

Copyでコマンドラインをコピーしてクライアントに宣言し、コンテキストをアクセス可能なクラスターにスイッチできます。


export KUBECONFIG="${KUBECONFIG}:${HOME}/.kube/querypie-kubeconfig"

QueryPie Agentセッティング初期化

セッティングを初期化すると入力したQueryPie Host情報が初期化されて再び入力できるようになります。

Agent内設定メニューで初期化

プロフィール領域右側⚙️ボタンをクリックして設定メニューを開きます。Reset All Settingsボタンをクリックします。

(Mac) メニューバー内アプリメニューで初期化

メニューバーでQueryPie Agentアイコンをクリックしてアプリメニューを開きます。Reset All Settingsボタンをクリックします。