diff --git a/confluence-mdx/etc/korean-titles-translations.txt b/confluence-mdx/etc/korean-titles-translations.txt index dc7f992de..46b039d87 100644 --- a/confluence-mdx/etc/korean-titles-translations.txt +++ b/confluence-mdx/etc/korean-titles-translations.txt @@ -43,6 +43,7 @@ Custom Data Source 접속하기 | Connecting to Custom Data Source # Kubernetes Access Control 접근 권한 목록 확인하기 | Checking Access Permission List +Web Client로 쿠버네티스 클러스터 접속하기 | Connecting to Kubernetes Clusters with Web Client # Web Access Control Root CA 인증서 및 Extension 설치하기 | Installing Root CA Certificate and Extension diff --git a/confluence-mdx/var/pages.qm.yaml b/confluence-mdx/var/pages.qm.yaml index 6144b7b66..0c50816ae 100644 --- a/confluence-mdx/var/pages.qm.yaml +++ b/confluence-mdx/var/pages.qm.yaml @@ -457,6 +457,21 @@ - "user-manual" - "kubernetes-access-control" - "checking-access-permission-list" +- "page_id": "2262630428" + "title": "Web Client로 쿠버네티스 클러스터 접속하기" + "title_orig": "Web Client로 쿠버네티스 클러스터 접속하기" + "breadcrumbs": + - "사용자 매뉴얼" + - "Kubernetes Access Control" + - "Web Client로 쿠버네티스 클러스터 접속하기" + "breadcrumbs_en": + - "User Manual" + - "Kubernetes Access Control" + - "Web Client로 쿠버네티스 클러스터 접속하기" + "path": + - "user-manual" + - "kubernetes-access-control" + - "web-client" - "page_id": "1064829218" "title": "Web Access Control" "title_orig": "Web Access Control" diff --git a/public/support/premium-support/image-20260715-083938.png b/public/support/premium-support/image-20260715-083938.png new file mode 100644 index 000000000..93f8a6a91 Binary files /dev/null and b/public/support/premium-support/image-20260715-083938.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/image-20260714-095819.png b/public/user-manual/kubernetes-access-control/web-client/image-20260714-095819.png new file mode 100644 index 000000000..b2716bdb2 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/image-20260714-095819.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/image-20260714-100251.png b/public/user-manual/kubernetes-access-control/web-client/image-20260714-100251.png new file mode 100644 index 000000000..a56367e7c Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/image-20260714-100251.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/image-20260714-101427.png b/public/user-manual/kubernetes-access-control/web-client/image-20260714-101427.png new file mode 100644 index 000000000..5e58d2fb1 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/image-20260714-101427.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/image-20260714-101804.png b/public/user-manual/kubernetes-access-control/web-client/image-20260714-101804.png new file mode 100644 index 000000000..2a8064031 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/image-20260714-101804.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/image-20260714-102425.png b/public/user-manual/kubernetes-access-control/web-client/image-20260714-102425.png new file mode 100644 index 000000000..33ccf4255 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/image-20260714-102425.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-log-viewer.png b/public/user-manual/kubernetes-access-control/web-client/web-client-log-viewer.png new file mode 100644 index 000000000..4baa6862b Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-log-viewer.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-events.png b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-events.png new file mode 100644 index 000000000..209712042 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-events.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-overview.png b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-overview.png new file mode 100644 index 000000000..3d0fe9a84 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-overview.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-relations.png b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-relations.png new file mode 100644 index 000000000..7d86821a4 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-relations.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-yaml.png b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-yaml.png new file mode 100644 index 000000000..8591dfbbb Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-yaml.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-resource-list.png b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-list.png new file mode 100644 index 000000000..8d658a39f Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-resource-list.png differ diff --git a/public/user-manual/kubernetes-access-control/web-client/web-client-shell-terminal.png b/public/user-manual/kubernetes-access-control/web-client/web-client-shell-terminal.png new file mode 100644 index 000000000..d0be24262 Binary files /dev/null and b/public/user-manual/kubernetes-access-control/web-client/web-client-shell-terminal.png differ diff --git a/src/content/en/support/premium-support.mdx b/src/content/en/support/premium-support.mdx index 06215aa99..2701f1216 100644 --- a/src/content/en/support/premium-support.mdx +++ b/src/content/en/support/premium-support.mdx @@ -21,23 +21,24 @@ Customers contracted through a partner should contact their partner representati * QueryPie Customer Portal: [Go to Portal](https://help.support.querypie.com/)
-image-20240801-023748.png +image-20260715-083938.png
-You can submit tickets for product inquiries, bug reports, and more, and track the progress of your tickets in real-time. -* Critical Outage - When immediate response is required, such as service interruption -* Defect Report - Bug and error reports -* PoC Installation Request - New environment setup requests -* General Inquiry - Questions about usage and configuration -* Feature Request - New feature suggestions +You can submit tickets for bug reports and urgent issues, and track ticket progress in real time. + +* Critical Issue Report - When immediate response is required, such as service interruption +* Bug Report - Bug and error reports + + +For feature additions and improvement requests, please contact us by email. [ai_connection@querypie.com](mailto:ai_connection@querypie.com) + #### Upgrades and Regular Maintenance When a new version of QueryPie is released, we announce the latest updates in the [Release Notes](../release-notes). Based on the annual subscription agreement, we support upgrades for major version releases. Minor version releases are limited to bug fixes only. -For upgrade and regular maintenance inquiries, please contact us through the [QueryPie Customer Portal](https://help.support.querypie.com/). #### Customer Portal Access Request @@ -45,4 +46,3 @@ Access is available for QueryPie Enterprise Edition customers. If you would like to participate, please fill out the application form through the link below, and we will send you a portal invitation link. * Access Request Link: [https://forms.gle/JKUtKR4ARbcy8XuDA](https://forms.gle/JKUtKR4ARbcy8XuDA) - diff --git a/src/content/en/user-manual/kubernetes-access-control/_meta.ts b/src/content/en/user-manual/kubernetes-access-control/_meta.ts index 5645d1d0c..067f54280 100644 --- a/src/content/en/user-manual/kubernetes-access-control/_meta.ts +++ b/src/content/en/user-manual/kubernetes-access-control/_meta.ts @@ -1,3 +1,4 @@ export default { 'checking-access-permission-list': 'Checking Access Permission List', + 'web-client': 'Connecting to Kubernetes Clusters with Web Client', }; diff --git a/src/content/en/user-manual/kubernetes-access-control/web-client.mdx b/src/content/en/user-manual/kubernetes-access-control/web-client.mdx new file mode 100644 index 000000000..205586795 --- /dev/null +++ b/src/content/en/user-manual/kubernetes-access-control/web-client.mdx @@ -0,0 +1,206 @@ +--- +title: 'Connecting to Kubernetes Clusters with Web Client' +confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/2262630428/Web+Client' +--- + +import { Callout } from 'nextra/components' + +# Connecting to Kubernetes Clusters with Web Client + +### Overview + + +KAC Web Client is currently provided as `Beta`. + + +With KAC Web Client, you can access Kubernetes clusters directly from your browser without installing a separate Agent, and explore and manage resources. + +You can enter from the cluster detail screen in the Kubernetes menu using the Connect button, or if you have already selected a Role and a specific cluster, you can go directly to Web Client from the top menu on the user page. + +
+Move to the Web Client screen by selecting a specific cluster on the cluster detail screen and clicking the `Connect` button +
+Move to the Web Client screen by selecting a specific cluster on the cluster detail screen and clicking the `Connect` button +
+
+ +#### Web Client Screen Layout + +
+The Web Client `Cluster Overview` displayed after connecting to a Role and a specific cluster +
+The Web Client `Cluster Overview` displayed after connecting to a Role and a specific cluster +
+
+ +When you connect, the **Cluster Overview** screen appears, where you can check the overall status of the cluster. + +* Left sidebar (**Resource Browser**): Browse resources in the cluster by category. +* Right main area: Displays the list or details of the selected resource. +* Bottom panel: Displays Pod logs and Shell terminal in tab format. It appears when you click the `Logs` or `Shell` button on the detail screen displayed after clicking a specific target in the list. +
+ Bottom panel exposed as tabs when the `Logs` or `Shell` button is clicked +
+ Bottom panel exposed as tabs when the `Logs` or `Shell` button is clicked +
+
+ +### Connecting to a Cluster + +#### Selecting a Role + +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+
+ + +* Click **Kubernetes** in the top menu. +* In the **Select a Role** popup dialog, select the Role to use for access and click **Select**. + * The list of accessible clusters varies depending on the Role. + * If you do not have any granted Roles, the list on the left is not displayed. Request the appropriate permission through the Access Role Request form in the Workflow menu. + +#### Connecting with Web Client + +
+image-20260714-102425.png +
+ + +* Click the cluster you want to access in the left panel. +* Click the `Connect` button on the detail screen on the right to connect with Web Client. + + +You can also connect using the existing Agent method by clicking the `Open Agent` button. +Refer to the Agent manual for Agent installation and usage. + + +### Checking Resource Lists + +
+*QueryPie Web > Web Client > Resource List* +
+*QueryPie Web > Web Client > Resource List* +
+
+ +When you select a resource type in the left sidebar, the list of corresponding resources is displayed. + +* You can select a specific Namespace from the **All Namespaces** dropdown to filter the list. +* You can search resources by entering part of a name in the **Filter by name** search field. +* You can create a new resource using the `+ Create` button. + +The resource categories that can be browsed are as follows. + +| Category | Included Resources | +| -------------------- | ---------------------------------------------------------------- | +| **Cluster** | Namespace, Node, PersistentVolume, ClusterRole, ClusterRoleBinding | +| **Workloads** | Pod, Deployment, StatefulSet, DaemonSet, ReplicaSet, Job, CronJob | +| **Config & Storage** | ConfigMap, Secret, PersistentVolumeClaim, StorageClass | +| **Network** | Service, Ingress, NetworkPolicy, Endpoints | +| **RBAC** | Role, RoleBinding, ServiceAccount | +| **Custom Resources** | CRD resources defined in the cluster | + +### Checking Resource Details + +Click an item in the resource list to open the detail panel on the right. +The detail panel consists of four tabs. + +#### Overview Tab + +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+
+ +You can check the resource metadata and status. + +* **Metadata**: Name, Namespace, UID, creation time, Status, Resource Version +* **Controlled By**: The parent resource that manages the resource (for example, Pod → DaemonSet) - click the name to move to the parent resource detail screen. +* **Containers**: For Pods, you can check the image, Ready status, and number of Restarts by container. +* **Labels / Annotations**: Labels and annotations configured on the resource + +#### YAML Tab + +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+
+ +You can check the full YAML definition of the resource and edit it directly. Click the **Edit** button to switch to edit mode, and when you save after making changes, they are immediately applied to the cluster. + +#### Events Tab + +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+
+ +You can check Kubernetes events related to the resource. +Events are recorded when status changes, scheduling, or errors occur. +If a Pod is running normally, there may be no events. + +#### Relations Tab + +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+
+ +Visualizes the hierarchy of resources related to the current resource in a tree format. +You can understand parent and child resource relationships at a glance, and click an item to move directly to the detail information of the related resource. + +### Checking Pod Logs + +
+*QueryPie Web > Web Client > Log Viewer* +
+*QueryPie Web > Web Client > Log Viewer* +
+
+ +1. Select **Pod** in the sidebar, and then click the Pod you want to check in the list. +2. Click the **Logs** button in the upper right of the detail panel. +3. The real-time logs of the corresponding Pod are streamed in the bottom panel. + 1. You can search logs by entering a keyword in the **Search logs** input field. + 2. Select the **Follow** checkbox to automatically follow the latest logs. + +### Connecting to a Pod Shell Terminal + +
+*QueryPie Web > Web Client > Shell Terminal* +
+*QueryPie Web > Web Client > Shell Terminal* +
+
+ +1. Select **Pod** in the sidebar, and then click the Pod you want to connect to in the list. +2. Click the **Shell** button in the upper right of the detail panel. +3. An interactive terminal opens in the bottom panel, where you can run commands directly in the Pod container. + + +Logs and Shell can be opened in multiple tabs at the same time. +Each tab displays the Pod name, so you can compare and work with logs and terminals for multiple Pods together. + + + +**Difference between Web Client and the existing Agent method** + +Q. What is the difference between Web Client and the existing Agent method? + +A. Web Client lets you browse Kubernetes resources, check logs, and access Shell using only a browser. +The Agent method enables a wider range of work by integrating with local tools, including kubectl. +Both methods operate under the same permission system (Role, Policy). + + +> diff --git a/src/content/ja/support/premium-support.mdx b/src/content/ja/support/premium-support.mdx index ba294cc59..f64a64dab 100644 --- a/src/content/ja/support/premium-support.mdx +++ b/src/content/ja/support/premium-support.mdx @@ -21,23 +21,24 @@ Customer Portalは、QueryPieと直接契約しているお客様のみご利用 * QueryPie Customer Portal：[こちら](https://help.support.querypie.com/)
-image-20240801-023748.png +image-20260715-083938.png
-製品に関するお問い合わせやバグ報告などをチケットとして登録でき、チケットの進捗状況をリアルタイムで確認できます。 -* 緊急障害発生 - サービス停止など即時対応が必要な場合 -* 不具合報告 - バグおよびエラーの報告 -* PoCインストール依頼 - 新規環境構築の依頼 -* 一般的なお問い合わせ - 使用方法や設定に関する質問 -* 製品機能のご提案 - 新機能のリクエスト +バグ報告や緊急の問題をチケットとして登録でき、チケットの進捗状況をリアルタイムで確認できます。 + +* 緊急問題レポート - サービス停止など即時対応が必要な場合 +* バグレポート - バグおよびエラーの報告 + + +機能追加や改善に関するお問い合わせは、メールでご依頼ください。[ai_connection@querypie.com](mailto:ai_connection@querypie.com) + #### アップグレードおよび定期メンテナンス QueryPieの新バージョンがリリースされると、[Release Notes](../release-notes)で最新アップデート情報をお知らせいたします。 年間サブスクリプション契約に基づき、メジャーバージョンリリース時にはアップグレードをサポートいたします。 マイナーバージョンリリースはバグフィックスのみが対象となります。 -アップグレードおよび定期メンテナンスに関するお問い合わせは、[QueryPie Customer Portal](https://help.support.querypie.com/)よりご連絡ください。 #### Customer Portalへの参加リクエスト @@ -45,4 +46,3 @@ QueryPie Enterprise Editionをご購入のお客様が対象となります。 参加をご希望の場合は、以下のリンクから申請書にご記入いただければ、ポータルへの招待リンクをお送りいたします。 * 参加リクエストリンク：[https://forms.gle/JKUtKR4ARbcy8XuDA](https://forms.gle/JKUtKR4ARbcy8XuDA) - diff --git a/src/content/ja/user-manual/kubernetes-access-control/_meta.ts b/src/content/ja/user-manual/kubernetes-access-control/_meta.ts index bf91cdefc..ca867a6cb 100644 --- a/src/content/ja/user-manual/kubernetes-access-control/_meta.ts +++ b/src/content/ja/user-manual/kubernetes-access-control/_meta.ts @@ -1,3 +1,4 @@ export default { 'checking-access-permission-list': 'アクセス権限一覧の確認', -}; \ No newline at end of file + 'web-client': 'Web ClientでKubernetesクラスターに接続する', +}; diff --git a/src/content/ja/user-manual/kubernetes-access-control/web-client.mdx b/src/content/ja/user-manual/kubernetes-access-control/web-client.mdx new file mode 100644 index 000000000..3d48975a4 --- /dev/null +++ b/src/content/ja/user-manual/kubernetes-access-control/web-client.mdx @@ -0,0 +1,206 @@ +--- +title: 'Web ClientでKubernetesクラスターに接続する' +confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/2262630428/Web+Client' +--- + +import { Callout } from 'nextra/components' + +# Web ClientでKubernetesクラスターに接続する + +### Overview + + +KAC Web Clientは現在 `Beta` として提供されています。 + + +KAC Web Clientを使用すると、別途Agentをインストールせずに、ブラウザーから直接Kubernetesクラスターに接続してリソースを探索し、管理できます。 + +Kubernetesメニューのクラスター詳細画面でConnectボタンからアクセスするか、Roleと特定のクラスターをすでに選択している場合は、ユーザーページ上部メニューのWeb Client項目から直接移動できます。 + +
+クラスター詳細画面で特定のクラスターを選択後、`Connect` ボタンをクリックしてWeb Client画面へ移動 +
+クラスター詳細画面で特定のクラスターを選択後、`Connect` ボタンをクリックしてWeb Client画面へ移動 +
+
+ +#### Web Client画面構成 + +
+Roleと特定のクラスターに接続した後に表示されるWeb Clientの `Cluster Overview` +
+Roleと特定のクラスターに接続した後に表示されるWeb Clientの `Cluster Overview` +
+
+ +接続すると、クラスターの全体状況を確認できる **Cluster Overview** 画面が表示されます。 + +* 左側サイドバー（**リソースブラウザー**）：クラスター内のリソースをカテゴリー別に探索します。 +* 右側メイン領域：選択したリソースの一覧または詳細情報を表示します。 +* 下部パネル：Podログの確認とShellターミナルをタブ形式で表示します。一覧で特定の対象をクリックして表示される詳細画面で `Logs` または `Shell` ボタンをクリックしたときに表示されます。 +
+ `Logs` または `Shell` ボタンをクリックしたときにタブとして表示される下部パネル +
+ `Logs` または `Shell` ボタンをクリックしたときにタブとして表示される下部パネル +
+
+ +### クラスターに接続する + +#### Roleを選択する + +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+
+ + +* 上部メニューで **Kubernetes** をクリックします。 +* **Select a Role** ポップアップダイアログで接続に使用するRoleを選択し、**Select** をクリックします。 + * アクセス可能なクラスター一覧はRoleによって異なります。 + * 付与されたRoleがない場合、左側の一覧は表示されません。WorkflowメニューのAccess Role Requestフォームから適切な権限を申請してください。 + +#### Web Clientで接続する + +
+image-20260714-102425.png +
+ + +* 左側パネルで接続するクラスターをクリックします。 +* 右側の詳細画面で `Connect` ボタンを押してWeb Clientに接続します。 + + +`Open Agent` ボタンをクリックすると、既存のAgent方式でも接続できます。 +Agentのインストールおよび使用方法はAgentマニュアルを参照してください。 + + +### リソース一覧を確認する + +
+*QueryPie Web > Web Client > Resource List* +
+*QueryPie Web > Web Client > Resource List* +
+
+ +左側サイドバーでリソース種別を選択すると、該当するリソース一覧が表示されます。 + +* **All Namespaces** ドロップダウンで特定のNamespaceを選択し、一覧をフィルターできます。 +* **Filter by name** 検索欄に名前の一部を入力してリソースを検索できます。 +* `+ Create` ボタンで新しいリソースを作成できます。 + +探索可能なリソースカテゴリーは次のとおりです。 + +| カテゴリー | 含まれるリソース | +| -------------------- | ------------------------------------------------------------------ | +| **Cluster** | Namespace, Node, PersistentVolume, ClusterRole, ClusterRoleBinding | +| **Workloads** | Pod, Deployment, StatefulSet, DaemonSet, ReplicaSet, Job, CronJob | +| **Config & Storage** | ConfigMap, Secret, PersistentVolumeClaim, StorageClass | +| **Network** | Service, Ingress, NetworkPolicy, Endpoints | +| **RBAC** | Role, RoleBinding, ServiceAccount | +| **Custom Resources** | クラスターに定義されたCRDリソース | + +### リソース詳細情報を確認する + +リソース一覧で項目をクリックすると、右側に詳細パネルが開きます。 +詳細パネルは4つのタブで構成されています。 + +#### Overviewタブ + +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+
+ +リソースのメタデータと状態を確認できます。 + +* **Metadata**: Name, Namespace, UID, 作成日時, Status, Resource Version +* **Controlled By**: 該当リソースを管理する上位リソース（例：Pod → DaemonSet）- 名前をクリックすると、上位リソースの詳細画面へ移動します。 +* **Containers**: Podの場合、コンテナー別のイメージ、Ready状態、Restarts回数を確認できます。 +* **Labels / Annotations**: リソースに設定されたラベルとアノテーション + +#### YAMLタブ + +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+
+ +リソースの完全なYAML定義を確認し、直接編集できます。**Edit** ボタンをクリックすると編集モードに切り替わり、変更後に保存するとクラスターへ即時に反映されます。 + +#### Eventsタブ + +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+
+ +リソースに関連するKubernetesイベントを確認できます。 +状態変化、スケジューリング、エラー発生時にイベントが記録されます。 +Podが正常に動作している場合、イベントがないことがあります。 + +#### Relationsタブ + +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+
+ +現在のリソースに関連するリソースの階層構造をツリー形式で可視化します。 +親子関係にあるリソースを一目で把握し、項目をクリックして関連リソースの詳細情報へ直接移動できます。 + +### Podログを確認する + +
+*QueryPie Web > Web Client > Log Viewer* +
+*QueryPie Web > Web Client > Log Viewer* +
+
+ +1. サイドバーで **Pod** を選択した後、一覧で確認するPodをクリックします。 +2. 詳細パネル右上の **Logs** ボタンをクリックします。 +3. 下部パネルに該当Podのリアルタイムログがストリーミングされます。 + 1. **Search logs** 入力欄にキーワードを入力してログを検索できます。 + 2. **Follow** チェックボックスを選択すると、最新ログを自動的に追跡します。 + +### Pod Shellターミナルに接続する + +
+*QueryPie Web > Web Client > Shell Terminal* +
+*QueryPie Web > Web Client > Shell Terminal* +
+
+ +1. サイドバーで **Pod** を選択した後、一覧で接続するPodをクリックします。 +2. 詳細パネル右上の **Shell** ボタンをクリックします。 +3. 下部パネルにインタラクティブターミナルが開き、Podコンテナーに直接コマンドを実行できます。 + + +LogsとShellは同時に複数のタブで開いて使用できます。 +各タブにはPod名が表示され、複数Podのログとターミナルをまとめて比較しながら作業できます。 + + + +**Web Clientと既存Agent方式の違い** + +Q. Web Clientと既存Agent方式の違いは何ですか？ + +A. Web ClientはブラウザーだけでKubernetesリソースの探索、ログ確認、Shell接続ができます。 +Agent方式はkubectlをはじめとするローカルツールと連携し、より幅広い作業が可能です。 +どちらの方式も同じ権限体系（Role, Policy）の下で動作します。 + + +> diff --git a/src/content/ko/support/premium-support.mdx b/src/content/ko/support/premium-support.mdx index 5d2fcd7fe..b7039ca87 100644 --- a/src/content/ko/support/premium-support.mdx +++ b/src/content/ko/support/premium-support.mdx @@ -21,23 +21,24 @@ Customer Portal 사용은 QueryPie와 직계약한 고객에 한해서 이용할 * QueryPie Customer Portal : [바로 가기](https://help.support.querypie.com/)
-image-20240801-023748.png +image-20260715-083938.png
-제품 문의, 버그 제보 등을 티켓으로 등록할 수 있으며 티켓의 진행 상황을 실시간으로 확인할 수 있습니다. -* 긴급 장애 발생 - 서비스 중단 등 즉시 대응이 필요한 경우 -* 결함 신고 - 버그 및 오류 제보 -* PoC 설치 요청 - 신규 환경 구성 요청 -* 일반 문의 - 사용 방법, 설정 관련 질문 -* 제품 기능 제안 - 신규 기능 요청 +버그 리포트와 긴급 이슈에 대해 티켓으로 등록할 수 있으며 티켓의 진행 상황을 실시간으로 확인할 수 있습니다. + +* 긴급 이슈 리포트 - 서비스 중단 등 즉시 대응이 필요한 경우 +* 버그 리포트 - 버그 및 오류 제보 + + +기능 추가 및 개선 문의는 메일로 요청 부탁드립니다. [ai_connection@querypie.com](mailto:ai_connection@querypie.com) + #### 업그레이드 및 정기 유지/보수 점검 QueryPie 신규 버전이 릴리스되면 [Release Notes](../release-notes)에 최신 업데이트 소식을 알려드립니다. 연간 구독 계약 기준에 따라 메이저 버전 릴리스 시 업그레이드를 지원해 드립니다. 마이너 버전 릴리스는 버그 픽스 건에 한 해 진행됩니다. -업그레이드 및 정기 유지/보수 점검 관련 내용은 [QueryPie Customer Portal](https://help.support.querypie.com/) 을 통해 문의해 주세요. #### Customer Portal 참여 요청 @@ -45,4 +46,3 @@ QueryPie Enterprise Edition 구매 고객을 대상으로 참여가 가능합니 참여를 원하는 경우, 아래 링크를 통해 신청서를 작성해 주시면 포탈 초대 링크를 보내드리겠습니다. * 참여 요청 링크 : [https://forms.gle/JKUtKR4ARbcy8XuDA](https://forms.gle/JKUtKR4ARbcy8XuDA) - diff --git a/src/content/ko/user-manual/kubernetes-access-control/_meta.ts b/src/content/ko/user-manual/kubernetes-access-control/_meta.ts index 556eba6ef..0fd7f9e13 100644 --- a/src/content/ko/user-manual/kubernetes-access-control/_meta.ts +++ b/src/content/ko/user-manual/kubernetes-access-control/_meta.ts @@ -1,3 +1,4 @@ export default { 'checking-access-permission-list': '접근 권한 목록 확인하기', + 'web-client': 'Web Client로 쿠버네티스 클러스터 접속하기', }; diff --git a/src/content/ko/user-manual/kubernetes-access-control/web-client.mdx b/src/content/ko/user-manual/kubernetes-access-control/web-client.mdx new file mode 100644 index 000000000..ad7cc5680 --- /dev/null +++ b/src/content/ko/user-manual/kubernetes-access-control/web-client.mdx @@ -0,0 +1,206 @@ +--- +title: 'Web Client로 쿠버네티스 클러스터 접속하기' +confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/2262630428/Web+Client' +--- + +import { Callout } from 'nextra/components' + +# Web Client로 쿠버네티스 클러스터 접속하기 + +### Overview + + +KAC Web Client는 현재 `Beta` 로 제공됩니다. + + +KAC Web Client를 사용하면 별도의 Agent 설치 없이 브라우저에서 직접 쿠버네티스 클러스터에 접속하여 리소스를 탐색하고 관리할 수 있습니다. + +Kubernetes 메뉴의 클러스터 상세 화면에서 Connect 버튼으로 진입하거나 Role과 특정 클러스터를 이미 선택한 경우 사용자 페이지 상단 메뉴에서 Web Client 항목으로 바로 이동할 수 있습니다. + +
+클러스터 상세 화면에서 특정 클러스터를 선택 후 `Connect` 버튼을 클릭하여 Web Client 화면으로 이동 +
+클러스터 상세 화면에서 특정 클러스터를 선택 후 `Connect` 버튼을 클릭하여 Web Client 화면으로 이동 +
+
+ +#### Web Client 화면 구성 + +
+Role과 특정 클러스터에 접속한 뒤 표시되는 Web Client의 `Cluster Overview` +
+Role과 특정 클러스터에 접속한 뒤 표시되는 Web Client의 `Cluster Overview` +
+
+ +접속하면 클러스터의 전체 현황을 확인할 수 있는 **Cluster Overview** 화면이 표시됩니다. + +* 좌측 사이드바 (**리소스 브라우저**): 클러스터 내 리소스를 카테고리별로 탐색합니다. +* 우측 메인 영역: 선택한 리소스의 목록 또는 상세 정보를 표시합니다. +* 하단 패널: Pod 로그 조회와 Shell 터미널을 탭 형식으로 표시합니다. 목록에서 특정 대상을 클릭하여 표시되는 상세화면에서 `Logs` 또는 `Shell` 버튼을 클릭했을 때 노출됩니다. +
+ `Logs` 또는 `Shell` 버튼을 클릭했을 때 탭으로 노출되는 하단 패널 +
+ `Logs` 또는 `Shell` 버튼을 클릭했을 때 탭으로 노출되는 하단 패널 +
+
+ +### 클러스터에 접속하기 + +#### Role 선택하기 + +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+QueryPie Web > Kubernetes > Kubernetes > Select a Role +
+
+ + +* 상단 메뉴에서 **Kubernetes**를 클릭합니다. +* **Select a Role** 팝업 다이얼로그에서 접속에 사용할 Role을 선택하고 **Select**를 클릭합니다. + * Role에 따라 접근 가능한 클러스터 목록이 달라집니다. + * 부여된 Role이 없는 경우 좌측 목록이 표시되지 않습니다. Workflow 메뉴의 Access Role Request 양식을 통해 적절한 권한을 신청하세요. + +#### Web Client로 접속하기 + +
+image-20260714-102425.png +
+ + +* 좌측 패널에서 접속할 클러스터를 클릭합니다. +* 우측 상세 화면의 `Connect` 버튼을 눌러 Web Client로 접속합니다. + + +`Open Agent` 버튼을 클릭하여 기존 Agent 방식으로도 접속할 수 있습니다. +Agent 설치 및 사용 방법은 Agent 매뉴얼을 참조하세요. + + +### 리소스 목록 확인하기 + +
+*QueryPie Web > Web Client > Resource List* +
+*QueryPie Web > Web Client > Resource List* +
+
+ +좌측 사이드바에서 리소스 종류를 선택하면 해당 리소스 목록이 표시됩니다. + +* **All Namespaces** 드롭다운에서 특정 Namespace를 선택해 목록을 필터링할 수 있습니다. +* **Filter by name** 검색창에 이름의 일부를 입력해 리소스를 검색할 수 있습니다. +* `+ Create` 버튼으로 새로운 리소스를 생성할 수 있습니다. + +탐색 가능한 리소스 카테고리는 다음과 같습니다. + +| 카테고리 | 포함 리소스 | +| -------------------- | ------------------------------------------------------------------ | +| **Cluster** | Namespace, Node, PersistentVolume, ClusterRole, ClusterRoleBinding | +| **Workloads** | Pod, Deployment, StatefulSet, DaemonSet, ReplicaSet, Job, CronJob | +| **Config & Storage** | ConfigMap, Secret, PersistentVolumeClaim, StorageClass | +| **Network** | Service, Ingress, NetworkPolicy, Endpoints | +| **RBAC** | Role, RoleBinding, ServiceAccount | +| **Custom Resources** | 클러스터에 정의된 CRD 리소스 | + +### 리소스 상세 정보 확인하기 + +리소스 목록에서 항목을 클릭하면 우측에 상세 패널이 열립니다. +상세 패널은 4개의 탭으로 구성됩니다. + +#### Overview 탭 + +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+*QueryPie Web > Web Client > Resource Detail > Overview* +
+
+ +리소스의 메타데이터와 상태를 확인할 수 있습니다. + +* **Metadata**: Name, Namespace, UID, 생성 시각, Status, Resource Version +* **Controlled By**: 해당 리소스를 관리하는 상위 리소스 (예: Pod → DaemonSet) — 이름을 클릭하면 상위 리소스 상세 화면으로 이동합니다. +* **Containers**: Pod의 경우 컨테이너별 이미지, Ready 상태, Restarts 횟수를 확인할 수 있습니다. +* **Labels / Annotations**: 리소스에 설정된 레이블과 어노테이션 + +#### YAML 탭 + +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+*QueryPie Web > Web Client > Resource Detail > YAML* +
+
+ +리소스의 전체 YAML 정의를 확인하고 직접 편집할 수 있습니다. **Edit** 버튼을 클릭하면 편집 모드로 전환되며, 수정 후 저장하면 클러스터에 즉시 반영됩니다. + +#### Events 탭 + +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+*QueryPie Web > Web Client > Resource Detail > Events* +
+
+ +리소스와 관련된 쿠버네티스 이벤트를 확인할 수 있습니다. +상태 변화, 스케줄링, 오류 발생 시 이벤트가 기록됩니다. +Pod가 정상적으로 동작 중이면 이벤트가 없을 수 있습니다. + +#### Relations 탭 + +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+*QueryPie Web > Web Client > Resource Detail > Relations* +
+
+ +현재 리소스와 연관된 리소스의 계층 구조를 트리 형태로 시각화합니다. +부모/자식 관계에 있는 리소스를 한눈에 파악하고, 항목을 클릭해 연관 리소스의 상세 정보로 바로 이동할 수 있습니다. + +### Pod 로그 확인하기 + +
+*QueryPie Web > Web Client > Log Viewer* +
+*QueryPie Web > Web Client > Log Viewer* +
+
+ +1. 사이드바에서 **Pod**를 선택한 후 목록에서 확인할 Pod를 클릭합니다. +2. 상세 패널 우측 상단의 **Logs** 버튼을 클릭합니다. +3. 하단 패널에 해당 Pod의 실시간 로그가 스트리밍됩니다. + 1. **Search logs** 입력창에 키워드를 입력해 로그를 검색할 수 있습니다. + 2. **Follow** 체크박스를 선택하면 최신 로그를 자동으로 따라갑니다. + +### Pod Shell 터미널 접속하기 + +
+*QueryPie Web > Web Client > Shell Terminal* +
+*QueryPie Web > Web Client > Shell Terminal* +
+
+ +1. 사이드바에서 **Pod**를 선택한 후 목록에서 접속할 Pod를 클릭합니다. +2. 상세 패널 우측 상단의 **Shell** 버튼을 클릭합니다. +3. 하단 패널에 인터랙티브 터미널이 열리며, Pod 컨테이너에 직접 명령어를 실행할 수 있습니다. + + +Logs와 Shell은 동시에 여러 탭으로 열어 사용할 수 있습니다. +각 탭에는 Pod 이름이 표시되어 여러 Pod의 로그와 터미널을 함께 비교하며 작업할 수 있습니다. + + + +**Web Client와 기존 Agent 방식의 차이** + +Q. Web Client와 기존 Agent 방식의 차이는 무엇인가요? + +A. Web Client는 브라우저만으로 쿠버네티스 리소스 탐색, 로그 확인, Shell 접속이 가능합니다. +Agent 방식은 kubectl을 비롯한 로컬 도구와 연동하여 더 폭넓은 작업이 가능합니다. +두 방식은 동일한 권한 체계(Role, Policy) 아래에서 동작합니다. + + +>