Webコンソール
Webコンソールは、ArkvoryのブラウザーUIです。サーバーの一部なので、別途インストールする必要はありません。サーバーのアドレスの/console/を開きます。たとえば、サーバー上ではhttp://127.0.0.1:8080/console/、HTTPSを設定した後はhttps://arkvory.example/console/です。
コンソールは、コマンドラインクライアントやSDKと同じHTTP APIを使います。サーバーはすべてのリクエストを検証します。ボタンが表示されない場合、それは、お使いのアカウントまたはキーでその操作を使えないことを示しているだけです。
画面構成
サイドバーにセクションがグループ化されています。狭い画面では、サイドバーがセクションボタンに変わります。
| グループ | セクション |
|---|---|
| ライブラリ | アーティファクト、パッケージ、ファイル履歴、アーティファクトの詳細 |
| 転送 | アップロード、ダウンロード |
| リソース | ユーザーとアクセス、リポジトリ、サービスアクセス、更新、バックアップ、はじめに、APIとCLI |
上部のバーには、セクションのタイトル、ファイルをアップロードボタン、フィードバックボタン、外観と言語のコントロールが表示されます。
各セクションには、#/catalog、#/packages、#/backupsのような固有のアドレスがあります。開いているアーティファクトのアドレスは#/artifact/<repository>/<id>です。これらのアドレスはブックマークしたり、他の人に送ったりできます。アドレスに、パスワード、キー、検索テキストが含まれることはありません。サインインする前にリンクを開いた場合、コンソールはサインイン後にそのリンクを開きます。
一部のセクションは、特定のユーザーにのみ表示されます。
| セクション | 表示されるユーザー |
|---|---|
| ユーザーとアクセス | 管理者 |
| リポジトリ | サインインしているすべてのユーザー |
| サービスアクセス | 回復キー、および権限を委任されたオペレーターのキー |
| 更新 | 管理者 |
| バックアップ | 管理者と回復キー |
サインイン
リポジトリへの接続カードはページの上部にあります。
- ユーザー名とパスワードを入力します。
- サインインを選択します。セッションは12時間続きます。
- コンソールは、読み取れる最初のリポジトリを選択します。別のリポジトリで作業するには、その名前を入力するか、一覧から選びます。
パスワードの代わりにキーで接続するには、サービスキーまたは自動化用のキーで接続を開き、キーを貼り付けて接続を選択します。キーはこのブラウザータブのメモリ内にだけ保持されます。コンソールがキーを保存することはありません。
サインアップは、管理者がセルフ登録を許可している場合にのみ表示されます。切断で接続を終了します。
パスワードでサインインすると、自分のパスワードを変更と個人用アクセストークンを使えるようになります。個人用アクセストークンは、自分のツールで使うキーです。アカウントとアクセスを参照してください。
最初の所有者
新しいインストールにはアカウントがありません。Windowsでは、セットアップが所有者を作成します。それ以外のインストールでは、コンソールで所有者を作成します。
- はじめにを開き、最初の所有者を作成を展開します。
- インストールディレクトリの
config/bootstrap-token.txtにある回復キーを貼り付けます。 - 名前と12文字以上のパスワードを入力し、所有者を作成を選択します。
- 新しい名前とパスワードでサインインします。
このフォームを使えるのは、アカウントが1つもない間だけです。所有者は管理者です。また、所有者はarkvory-ownersグループを通じて、releasesリポジトリへの書き込み権限も持ちます。
ライブラリ
アーティファクト
アーティファクトには、リポジトリの公開済みファイルが一覧表示されます。名前またはメタデータの値で検索できます。ラベルで絞り込みで1つのラベルだけを表示し、メタデータの完全一致でキーと値を完全一致で絞り込みます。各行には、名前、サイズ、公開日時、ステージ、ラベルが表示されます。ダウンロードを選択するとファイルをダウンロードし、開くを選択すると詳細を表示します。さらに読み込むで次のページを表示します。
パッケージ
パッケージには、登録済みのUPackバージョンが一覧表示されます。UPackグループとパッケージ名で絞り込み、並べ替えとグループ化を選んで、適用を選択します。ステージの列には、各バージョンがプロモートされている先が表示されます。パッケージを参照してください。
ファイル履歴
builds/game/1.4/GameSetup.exeのようなファイルパスは、何度でも新しいコンテンツを指し示すことができます。変更のたびに、新しいバージョンが作られます。ファイル履歴でパスを入力し、履歴を読み込むを選択します。各バージョンが、作成者と日時とともに表示されます。任意のバージョンを開いて、元のコンテンツをダウンロードできます。古いバージョンを復元すると新しいバージョンが作られ、何も削除されません。ファイルとパスを参照してください。
アーティファクトの詳細
アーティファクトの詳細には、1つのアーティファクトが表示されます。
- 概要：サイズ、アップロード日時、SHA-256と、コピーボタン。
- プロパティ：ラベル、コレクション、ビルドのメタデータ。変更を保存を選択して保存します。ファイル自体は変わりません。
- 操作：ダウンロード。ダウンロードリンクは、キーなしで1時間有効なリンクを作成します。UPackとして登録は、UPackアーカイブを索引に登録します。
- ファイル参照：ファイルを割り当ては、このアーティファクトをファイルパスの現在のコンテンツにします。
- プロモーション：ステージを追加は、
qaやreleaseなどのステージをアーティファクトに付けます。プロモートは、別のリポジトリに公開します。プロモーションを参照してください。 - マニフェストと追加ファイル：添付ファイルを追加は、マニフェスト、SBOM、署名、レポートなどのファイルをこのビルドに関連付けます。添付ファイルの履歴には、以前のセットが表示されます。
- アーティファクトの削除：依存関係を確認は、そのアーティファクトを今も使っているものを表示します。削除するには、アーティファクトのIDを貼り付けてこのアーティファクトを削除を選択します。
転送
アップロード
アップロードでファイルを選び、アップロード / 再開を選択します。コンソールはまずファイルのSHA-256を計算し、それからパートに分けて送信します。一時停止で転送を止めます。アップロード済みのパートは保持されます。
後で再開するには、アップロードIDを控えておきます。アップロードを再開を開き、同じファイルを選択して、アップロードIDを入力します。アップロード中にページを離れようとすると、ブラウザーが警告を表示します。転送を参照してください。
ダウンロード
ダウンロードは、コンソールからダウンロードするファイルのキューです。コンソールは、最終的なファイルを保存する前に、各ファイルのSHA-256を確認します。
- キューの設定で、同時ダウンロード数（1〜8）、開始間隔（ms）、キューの待機時間の上限（秒）を設定します。
- すべて一時停止、キューを再開、待機中をキャンセル、すべてキャンセル、完了済みを削除は、キュー全体を操作します。
- ページを再読み込みした後は、もう一度サインインし、キューを復元を選択します。続いて各ファイルを再開し、保存先を選びます。
大きなファイルのダウンロードには、安全なアドレス（HTTPSまたはローカルコンピューター）上のChromeまたはEdgeが必要です。一時データは、ブラウザーのプライベートストレージに保存されます。
リソース
ユーザーとアクセス
管理者はここで人を管理します。アカウントにアカウント、グループと権限にグループが一覧表示されます。ユーザーを作成、パスワードをリセット、グループを作成、グループメンバーの管理を使います。リポジトリアクセスの管理で、リポジトリ名を指定して、グループに読み取りまたは読み取りと書き込みのアクセス権を付与します。リポジトリを個別に作成する手順はありません。アクセス権の付与またはサービスポリシーでその名前が指定された時点で、リポジトリが存在するようになります。
リポジトリ
リポジトリには、表示できるリポジトリが自分の権限とともに表示されます。各カードにはファイルを開くとストレージとクリーンアップ（クォータ、自動クリーンアップ、物理クリーンアップ）があり、管理者にはアクセスの管理も表示されます。ミラーされたリポジトリにはミラーのバッジが表示されます。リポジトリとストレージを参照してください。
サービスアクセス
ここでは、ツールやCIシステム用のアカウントを作成します。このセクションを表示するには、回復キーまたはオペレーターのキーで接続します。サービスアカウントを作成を選択し、リポジトリの権限を設定します。読み取りプリセットと公開プリセットは、よく使う権限のセットを入力します。
キーを発行するには、サービスキーを開いてキーを発行を選択します。シークレットが表示されるのは1回だけです。コピーして、シークレットを保存しましたにチェックを入れ、キーを有効化を選択します。有効化されていないキーは、15分後に期限切れになります。キーを置き換えるにはローテーション、停止するには取り消すを使います。管理の委任では、所有者がオペレーターに限定的な管理権限を付与できます。
更新
更新には、インストール済みのバージョンと最新の安定版リリースが表示されます。今すぐ確認または更新をインストールを選択します。自動更新で互換性のある安定版リリースを自動的にインストールするをオンにし、メンテナンス時間帯（UTC）を選びます。更新を参照してください。
バックアップ
バックアップには、バックアップが正常かどうか、最新のバックアップ、次回の実行、バックアップエージェント、バックアップの保管庫が表示されます。今すぐバックアップを選択するとバックアップを開始します。復元ポイントには復元ポイントが一覧表示され、ポイントの全バイトを検証したり、固定したりできます。スケジュールと保持では、毎日の実行時刻、タイムゾーン、保持するポイントの数を設定します。復元は、サーバー上で実行するコマンドです。バックアップを参照してください。
はじめにとAPIリファレンス
はじめにには、新しいサーバーの最初の手順が表示されます。APIとCLIには、コマンドの例が一覧表示されます。許可されたAPI操作を読み込むは、現在のアカウントまたはキーで呼び出せるAPI操作を表示します。
フィードバック
サインイン後にフィードバックを使うと、ハブ経由でProAnimaStudioにメッセージを送信できます。画像を最大6枚と、返信用のメールアドレスを添付できます。管理者はサーバーログも添付できます。添付される内容を表示を選択すると、送信される内容をそのまま確認できます。
外観と言語
外観には3つの選択肢があります。システム、ライト、ダークです。言語には、コンソールのすべての言語が、その言語自身の名前で一覧表示されます。English、Русский、Español、Français、Deutsch、Português、中文、日本語、한국어、हिन्दी、العربيةです。ページは、再読み込みも入力内容の消失もなく、すぐに切り替わります。アラビア語は右から左に表示されます。初回アクセス時は、コンソールはブラウザーの言語に従い、一致するものがなければ英語になります。APIとCLIのドキュメントを開くと、コンソールの言語でこのドキュメントが開きます。ブラウザーが保存するのはテーマと言語だけで、アカウントやリポジトリに関する情報は保存しません。