archi bot 製品ドキュメント

この翻訳は機械生成です(ベータ版)。正本は英語のガイドです。

はじめに

Archibot へようこそ

Archibot Console の用途、初回サインインの仕組み、サインイン後に表示される画面、そして共有しても安全な情報について説明します。

顧客管理者顧客メンバープラットフォームオペレーター

最終更新

Workspace グリッド、Filter workspace list、Fleet summary タブを備えた My Workspaces グリッドと、ロールに応じた左ナビゲーションレールを表示する Archibot Console。
安全なデータを使った Console の例: ほとんどのユーザーは My Workspaces に到達します。左レールには自分のロールで開けるセクションが一覧表示され、フッターには言語、フィードバック、テーマ、アカウントの各コントロールがあります。

Archibot Console の用途

Archibot Console は、アカウントの準備、Archibot ワークスペースの作成、エディターでの起動、使用状況の確認、サポートの取得を行うための顧客向けの場所です。通常の顧客業務でサービストークン、Kubernetes アクセス、内部サービスアドレス、プラットフォーム管理ツールが必要になることは決してありません。

Console は次の用途に使用します:

  • アカウントのセットアップと顧客オンボーディングの詳細。
  • ユーザーの招待と顧客ロールの確認。
  • 承認済みのテンプレートとバックアップからのワークスペース作成。
  • ロールが許可する場合の CI & Review、Environments、Shared Drive のステータス確認。
  • アクティブな CI、QA、ボット、ワークスペース、ストレージ、容量のシグナルについて、顧客スコープの Operations を監視する。
  • ブラウザーで Archibot を開く、またはデスクトップエディターへの引き継ぎ。
  • 顧客ワークスペースの停止、更新、削除。
  • ロールが許可する場合の使用状況と請求準備状況の確認。

初回のサインイン方法

  1. ISM から提供された Console の URL を開きます。
  2. サインインページで Continue with SSO を選択します。
  3. 組織のサインインを完了するか、招待を承認します。
  4. Console に戻り、左ナビゲーションレールが自分のロールに一致していることを確認します。

アクセス拒否ページが表示された場合は、ID プロバイダーからサインアウトし、Console の URL を再度開いてください。同じ問題が繰り返される場合は、会社名、メールアドレス、想定したロール、サインインに失敗したおおよその時刻をサポートに送信してください。招待トークンや Cookie は送信しないでください。含めるべき情報については トラブルシューティングサポートへの引き継ぎ を参照してください。

サインイン後に表示される画面

Console は最初の画面を自動的に選択します:

  • アカウントに ArchibotChat アクセスと利用可能なクレジットがある場合、Console は Chat を直接開きます。これはチャット優先アカウントのデフォルトです。
  • それ以外の場合は、上に示したワークスペースグリッドである My Workspaces に到達します。
  • アカウントにまだセットアップが必要な場合、Console は基本が完了するまで Account Setup(顧客管理者向け)またはプラットフォームアクセス(オペレーター向け)へ誘導します。

セクションは左レールからいつでも切り替えられます。レールで Chat または My Workspaces を選択すると、自動デフォルトが別の場所に送った場合でも、期待どおりの場所に移動します。

My Workspaces のランディング画面には 3 つのタブがあります:

タブ表示内容
Workspace gridステータス、スケジュール、行ごとのアクションを備えた、テーブルまたはカード形式のワークスペース。
Filter workspace listテンプレート、ターゲット、ソース、ステータスなどのフィルターで、大規模なフリートを絞り込みます。
Fleet summary実行中、要注意、合計のワークスペースのロールアップ件数。個人スコープでは Workspace summary と表示されます。

グリッド、列、行ごとのコントロールの詳細を学ぶには、ワークスペースの管理 を参照してください。

ナビゲーションレールとそのフッター

左レールには、自分のロールで開けるセクションのみが一覧表示されます。一般的な項目には ChatMy WorkspacesCreateBackupsEnvironmentsCI & Review があります。顧客管理者とオペレーターには BotsOperations も表示されます。レールのフッターには、アカウント全体に関わるいくつかのコントロールがあります:

  • インターフェース言語を切り替える Console language セレクター。
  • Archibot チームにメモを送る Feedback
  • ライトモードまたはダークモードの テーマ 切り替え。
  • レールを狭くする collapse コントロール。
  • アカウントアクセスページを開く アカウントチップ(イニシャル、メール、ロール)。
  • Log out

言語、テーマ、アクセシビリティのオプションの詳細については、Console の設定とアクセシビリティ を参照してください。

ロールを確認する

レールフッターのアカウントチップには、Customer admin、Customer member、Customer viewer、Platform operator、Platform admin など、Console が自分に対して使用しているロールが表示されます。ロールが間違っているように見える場合はナビゲーションも間違っているため、作業を始める前に確認してください。

一部のオペレーターおよび管理者アカウントは、レールフッターから顧客ロールをプレビューして、顧客管理者やメンバーに見えるものを確認できます。ロールプレビューがアクティブな場合は目のインジケーターが表示され、いつでもプレビューを停止できます。ロールプレビューは Console での見え方を変えるだけで、誰の実際の権限も変更しません。ロールモデルの全体については、アクセスロール を参照してください。

次に行うこと

ロール最初のページ目標
顧客管理者Account Setup会社の詳細、SSO ステータス、招待、準備状況、顧客 Operations を確認する。
顧客メンバーMy Workspaces顧客アカウントに割り当てられたワークスペースを開始または作成する。
プラットフォームオペレーターPlatform access顧客のセットアップ、請求状態、SSO 引き継ぎ、CI/review の状態、環境、Shared Drive の証跡、サポートコンテキストを確認する。
プラットフォーム管理者Platform access必要に応じて、プラットフォーム全体の顧客境界とポリシーに敏感な操作を確認する。

おすすめの次のステップ:

ワークスペースの削除に関する注意

グリッドからワークスペースを削除すると、何かが削除される前に Console が確認ダイアログを表示します。ダイアログにはワークスペース名が示され、削除の確認を求められるため、一度の誤クリックで作業が失われることはありません。ダイアログを読み、ワークスペース名が一致していることを確認してから、初めて確定してください。ワークスペースの停止は元に戻せますが、削除は元に戻せません。停止、更新、削除のフロー全体については、ワークスペースの管理 を参照してください。

安全な情報共有

会社の連絡先、リポジトリの場所、バックアップの選択、機密でない ID プロバイダーのメタデータ、ロールの想定、表示されている Console のエラーメッセージは共有してかまいません。

パスワード、秘密鍵、API キー、Cookie、生のトークン、一回限りの招待リンク、Webhook シークレット、データベース URL、支払い認証情報、kubeconfig、またはこれらの値を露出するスクリーンショットは共有しないでください。

クイックリカバリーガイド

症状最初のアクションエスカレーション時に添える情報
想定したページが見つからないアカウントチップでロールを確認し、サインアウトして再度サインインする。メール、会社、想定ロール、表示されているナビゲーション。
招待がアクセス拒否になるID プロバイダーからサインアウトし、招待を再度開く。招待受信者のメールとおおよその時刻(招待リンクは不可)。
ワークスペースの作成がブロックされるブロック内容を読み、該当するガイドを開く。ワークスペースのターゲット、テンプレート、表示されているブロック内容、アカウント名。

完了の条件

  • 想定どおりの ID プロバイダーでサインインできる。
  • ナビゲーションレールが自分のロールに一致している。
  • Chat と My Workspaces のどちらに到達するか、次にどのページを開くべきかを把握している。