差分

このページの2つのバージョン間の差分を表示します。

--- software:plasticscm [2023/12/29 10:07] – oga
+++ software:plasticscm [2023/12/29 16:13] (現在) – [log] oga
@@ 行 1: / 行 1: @@
 ====== Unity Version Control (PlasticSCM) ======
+===== 名称のゆらぎ =====
+  * Plastic SCM
+  * Unity Version Control (UVC)
+  * Unity VCS
+  * Unity DevOps Version Control
 ===== Repository =====
-REPOSITORYNAME@SERVERNAME
+  * 「@」区切りで複数の要素の結合が行われる
+  * 要素の詳細は「名前:」で与えることができる。明らかな場合は省略もできる。
+    * repserver, rep, br, cs, wk 等
+  * https://docs.unity.com/ugs/en-us/manual/devops/manual/uvcs-cli/objectspec
+==== Repository の表記 ====
+  * REPOSITORYNAME@SERVERNAME
+  * rep:REPOSITORYNAME@repserver:SERVERNAME
 ^ SERVERNAME     ^      ^
 | 組織名@cloud   | Cloud サーバー      |
-| local          | PC 上のサーバー      |
+| local          | Local PC 上のサーバー      |
 | HOST:PORT       | 任意ホストのサーバー      |
+==== Branch ====
+  * / 区切りで階層表現
+  * ルートの「/」は省略可能
+  * BRANCHNAME@REPOSITORYNAME@SERVERNAME
+  * br:BRANCHNAME@rep:REPOSITORYNAME@repserver:SERVERNAME
+==== Workspace ====
+Perforce と同じように、リポジトリと PC 上のローカルフォルダの関連付けのために Workspace が必要。
+  * WORKSPACENAME@PCNAME
+  * wk:WORKSPACENAME@PCNAME
+===== CLI =====
+  * Command Line Interface (cli) は cm コマンド。
+  * Full Mode と Partial Mode (Gluon) の 2種類が存在する。
+==== log ====
+  * cm log は「最新 10個だけ」のような個数指定ができない。
+    * デフォルトでは一ヶ月分全部表示してしまう。
+    * log 以外の history などのコマンドも同様で、log 以外は逆順表示ができない(古い方からの列挙)
+  * perforce のようなワイルドカードによるマッチングができない。
+==== workspace ====
+  * workspace 一覧「cm workspace list」
+  * workspace 作成「cm workspace create WORKSPACENAME LOCALPATH REPOSITORY」
+==== branch ====
+  * branch 一覧「cm find branch」
+==== partial mode ====
+<code>
+cm workspace create WORKSPACENAME LOCALPATH rep:REPOSITORY
+cd LOCALPATH
+cm partial configure +/PATH/FOLDER
+～
+cm partial add FILE
+cm partial ci -c=MESSAGE
+cm partial update
+cm partial switch /main/test
+～
+cm partial update
+</code>
+===== Script 言語用 API =====
+==== REST API ====
+  * script 言語用の SDK が用意されているわけではなく、自分自身の PC 上で web server を起動し、web API (REST API) を経由して使用する。
+  - コマンドラインから「cm api」を実行するとサーバーが起動する
+  - script 言語から表示されている URL (自分自身の PC) にアクセスして web API を実行する
+==== xml ====
+  * cm コマンドは xml 出力オプションがあるので、コマンド実行結果を xml を経由して読み込むことができる。
+===== Local Server =====
+  * Client ソフトウエア (Cloud Edition) をインストールすると、同時に Local Server のインストールも行われる。
+  * Windows のサービスとして「Plastic Change Tracker」「Plastic SCM Server」の 2つが起動している。
+  * リポジトリを Local Server に切り替えると自分自身の PC 上のリポジトリに格納される。
+  * Local Server の場合は、Cloud と違い容量制限がなく巨大なファイルの格納も可能
+    * ただしデフォルトで PlasticSCM のインストール先と同じドライブ (C: ドライブ) に格納されるので注意
+  * 参考にさせていただいたページ
+    * https://zenn.dev/shiena/scraps/b20cb569d6b692
+==== Local Server のリポジトリ保存先の変更方法 ====
+  - 「コンピュータの管理」から Windows のサービス「Plastic SCM Server」を停止する
+  - C:\Program Files\PlasticSCM5\server\jet フォルダを他のドライブにコピーする
+    * 説明ではコピー先を D:\data\jet 仮定とする
+  - 以下のテキストファイル jet.conf を作成して C:\Program Files\PlasticSCM5\server\jet.conf に配置する
+  - 「コンピュータの管理」で Windows のサービス「Plastic SCM Server」を起動し直す
+<file text jet.conf>
+basepath=D:\data\jet
+</file>
+  * https://docs.plasticscm.com/administration/plastic-scm-version-control-administrator-guide