クローン済み vs 非クローン ワークスペース
ワークスペースは クローン済み(ローカル)または 非クローン(クラウドのみ)のいずれかです。違いを理解することで、ワークフローの設定方法を判断しやすくなります。
クローン済みワークスペースを使うタイミング: ほとんどの場合。コードを書いたり、ゲームエンジンでアセットを編集したり、ローカルツールを使ったりして積極的に開発している場合は、それらのツールがディスク上のファイルにアクセスできるように、クローン済みワークスペースが必要です。
非クローンワークスペースを使うタイミング: ローカルで編集せずに、ファイルの閲覧、変更のレビュー、ブランチの管理だけをしたいとき。プロジェクト全体をダウンロードしたくないマシンからの軽量なアクセスや、大規模なリポジトリをディスク上に複製せずに複数のワークスペースを管理するのに便利です。
非クローンワークスペースはいつでもクローンできます — 下の ワークスペースをローカルにクローンする を参照してください。
新しいワークスペースの作成
デスクトップアプリで:1
ワークスペースセレクタを開く
リポジトリビューの右上にあるワークスペースセレクタを開きます。
2
'+ New workspace' をクリックする
これで Create New Workspace ダイアログが開きます。
3
ワークスペース名を入力する
ワークスペースに分かりやすい名前を付けます。これは必須です。デスクトップアプリでは、Clone this workspace locally オプションをオンにして、すぐにローカルコピーを作成することもできます。クローンする場合は、フォルダー名とマシン上のディレクトリを選ぶ必要があります。
4
'Create' または 'Create & clone' をクリックする
ワークスペースはリポジトリのデフォルトブランチから作成されます。準備ができると、新しいワークスペースに自動的に遷移します。
複数のコンピューターから作業する
デスクトップとラップトップなど、複数のマシンから同じプロジェクトで作業できます。1 つのワークスペースを共有するのではなく、各マシンで別々のワークスペースをセットアップしてください。シートはマシン単位ではなくユーザー単位です。同じアカウントで複数のコンピューターから作業しても、追加のシートは使用されません。 マシン間はコミットを通じて同期されます。未コミットの変更は、保存するたびに自分のクラウドワークスペースにアップロードされます。ただし、別のコンピューター上のワークスペースは、コミットするまでそれらを受け取りません。コミットすると、そのブランチを追跡するすべてのワークスペースが自動的に受け取ります。コミットせずに 未コミットの 作業をマシン間で移動するには、シェルフ を使用してください。クラウドに保存され、同じリポジトリの任意のワークスペースから利用できます。2 台目のマシンをセットアップする
1
2 台目のマシンに Diversion をインストールする
プライマリマシンで使用しているのと同じアカウントでサインインします。
2
そのマシンで新しいワークスペースを作成する
新しいワークスペースの作成 の手順に従い、ローカルにクローンします。ワークスペースを区別できるように、マシンを識別できる名前(例:
main-laptop)を付けます。3
作業を開始する
新しいワークスペースは自動的に同期されます。あるマシンから別のマシンへの変更の伝わり方については、下の マシン間で作業を移動する を参照してください。
マシン間で作業を移動する
作業はコミットを通じてマシン間を移動します:- 作業中のマシンでコミットする。 クラウドにアップロードされるのはコミットされた変更だけであり、同期がアクティブなときだけです — なので作業をコミット(
dv commit -a -m "message"またはデスクトップアプリで)し、同期が一時停止していないことを確認してください。 - コミット先のブランチで変更を見つける。 各コミットはブランチに配置され、ワークスペースは現在いるブランチのコミットのみを表示します。別のマシンで行った変更を見るには、デスクトップアプリで ブランチセレクタ を開くか(または
dv checkout <branch>を実行して)、コミット先のブランチに切り替えます。 - ワークスペースを更新させる。 自動更新 がオンの場合、ワークスペースは新しいコミットを自動的に取り込みます — チームメイトのワークスペースと同じです。オフの場合、ワークスペースヘッダーの
dv.commit.<id>に更新 をクリックするか、dv updateを実行します。同期ステータス を参照してください。 - 選択同期(Selective Sync)がディスクに何を配置するかを決定します。 ワークスペースメニューの Selective sync でチェックが外れているフォルダーは、コミットされていてもローカルにダウンロードされません。参照: 選択同期。
同じマシン上の複数のワークスペース
1 台のマシンに、同じリポジトリのワークスペースを複数置くことができます。たとえば、ブランチごとに 1 つ、またはドライブごとに 1 つのワークスペースを用意できます。これにより、大規模なプロジェクトでブランチを切り替える必要がなくなります。 各ワークスペースは、それぞれのフォルダーから同期します。別のワークスペースをセットアップする
1
新しいワークスペースでリポジトリをもう一度クローンする
Remote Repositories タブでリポジトリの … メニューを開き、Clone repo を選択して、Create new workspace を選択したままにします。ワークスペース内にないフォルダーを選択してください。
2
同期するフォルダーを選択する(任意)
各ワークスペースは、それぞれ独自にファイルをダウンロードします。ダウンロード量を減らすには、Folders to sync の行で Choose… をクリックし、不要なフォルダーのチェックを外します。それらのフォルダーはダウンロードされません。クローン前にフォルダーを選択する を参照してください。
3
作業するブランチに切り替える
新しいワークスペースはデフォルトブランチから始まります。ブランチセレクターで切り替えるか、そのフォルダー内で
dv checkout <branch> を実行します。dv clone <repo_id> <path> --new-workspace --ref <branch>。clone コマンド を参照してください。
コピーしたワークスペースフォルダー
ワークスペースが別のフォルダーから同期している間に、ワークスペースフォルダーのコピー内でdv を実行すると、コマンドは停止します。エラーメッセージには、現在同期しているフォルダーが表示されます。
- 代わりにコピーを同期するには: デスクトップアプリで ワークスペースのアタッチ を使用します。または、現在同期しているフォルダーで
dv unregisterを実行してから、コピー内でdvを実行します。 - 両方のフォルダーで作業するには: 新しいワークスペースを使ってリポジトリをもう一度クローンします。別のワークスペースをセットアップする を参照してください。
外部ストレージ上のワークスペース
USB ドライブ、外付け SSD、または通常のローカルディスクとしてマウントされる他の取り外し可能なドライブに、クローン済みワークスペースを保管できます。これにより、各マシンに Diversion がインストールされ、同じアカウントでサインインしていれば、再クローンなしでマシン間でワークスペースを持ち運べます。1
外部ドライブにワークスペースをクローンする
クローン時、ローカルの場所として外部ドライブ上のフォルダーを選択します。
2
他のワークスペースと同様に使用する
ドライブが接続され、Diversion エージェントが実行されていれば、ワークスペースは通常どおり同期します。
3
ドライブを再接続した後に再アタッチする
ドライブを再接続してもワークスペースが表示されない場合 — または別のマシンに接続した後 — ワークスペースのアタッチ を使って、ドライブ上のワークスペースフォルダーを Diversion に指し示してください。
ワークスペースの名前変更
1
Workspaces ページを開く
アバターをクリックして Organization settings を選択し、左サイドバーの Repositories をクリックし、リポジトリ列の Workspaces をクリックします。列の上部のピッカーで正しいリポジトリが選択されていることを確認してください。ワークスペースを見つけ、行末のアクションメニューをクリックし、Rename を選択します。
2
新しい名前を入力する
Rename Workspace ダイアログには現在の名前が入力済みで表示されます。希望の新しい名前を入力します。
3
'Rename' をクリックする
名前が空または変更されていない場合、ボタンは無効になっているので、必ず異なる名前を入力してください。
ワークスペースの削除
1
Workspaces ページを開く
アバターをクリックして Organization settings を選択し、左サイドバーの Repositories をクリックし、リポジトリ列の Workspaces をクリックします。列の上部のピッカーで正しいリポジトリが選択されていることを確認してください。ワークスペースを見つけ、行末のアクションメニューをクリックし、Delete を選択します。
2
削除を確認する
Delete Workspace ダイアログで確認を求められます。ワークスペース内の未コミットの変更はすべて失われることを覚えておいてください。
ワークスペースがローカルにクローンされている場合、ローカルファイルはディスクに残るが Diversion とは同期されなくなるという追加の警告が表示されます。続行する前に確認チェックボックスをオンにする必要があります。
3
'Delete' をクリックする
このアクションは永続的です — ワークスペースと未コミットの変更は永久に失われます。
ワークスペースをローカルにクローンする(デスクトップのみ)
まだマシンにクローンされていないワークスペースがある場合、いつでもローカルの同期コピーをセットアップできます。1
ワークスペースセレクタを開く
リポジトリビューの右上のワークスペースセレクタを開きます。このマシンにクローンされていないワークスペースは Remote の下に表示されます。ローカルにクローンしたいものを選択します。
2
同期するフォルダーを選択する(任意)
クローンダイアログには、ワークスペースの現在の選択内容を示す Folders to sync 行があります。Choose… をクリックすると、クローン開始前に選択内容を変更でき、選択しなかったフォルダーは一切ダウンロードされません。参照: 選択同期。
3
ディレクトリを選ぶ
ディレクトリピッカーが開きます — マシン上でローカルコピーを配置したい場所を選択します。
4
同期を待つ
Diversion がローカルコピーを作成し、自動的に同期を保ちます。ローカルで加えた変更はクラウドワークスペースに反映され、その逆も同様です。
ワークスペースのアタッチ(デスクトップのみ)
マシン上でリポジトリを別のパスに移動した場合、またはポータブルドライブを取り外した後にワークスペースが表示されない場合、Diversion に再アタッチできます。1
'Attach workspace' ボタンをクリックする
ダッシュボードで、ツールバーの Attach workspace ボタンをクリックします。
2
ワークスペースフォルダーを参照する
ディレクトリピッカーが開きます。ワークスペースを含むフォルダー(内部に
.diversion ディレクトリがあるフォルダー)に移動します。3
'Connect' をクリックする
Diversion がサーバー上でワークスペースを検索し、再接続します。ワークスペースの再アタッチが成功すると、確認メッセージが表示されます。ワークスペースは、すぐにこのフォルダーからの同期を開始します。
ワークスペースフォルダーには、Diversion がワークスペースの状態を追跡するために使用する隠しの
.diversion ディレクトリが含まれています。このフォルダーはそのままにしておく必要があり、変更したり削除したりしないでください。存在を確認するには、ファイルエクスプローラで隠しファイルを表示してください(Windows:View > Show > Hidden items、macOS:Cmd+Shift+. を押す)。存在しない場合、またはワークスペースがサーバーから削除されているか、アクセス権がない場合は、エラーメッセージが表示されます。ワークスペースがすでに別のフォルダーから同期している場合
ワークスペースが同期するフォルダーは 1 つだけです。ワークスペースフォルダーのコピー(新しいドライブにコピーしたものなど)を選択すると、ダイアログにはワークスペースが現在同期しているフォルダーが表示されます。
- Diversion は古いフォルダーの同期を停止し、そのワークスペース設定(
.diversionディレクトリ)を削除します。古いフォルダー内のファイルはディスク上に残ります。 - ワークスペースは新しいフォルダーの内容を引き継ぎます。2 つのフォルダーで内容が異なるファイルがある場合、Diversion は新しいフォルダーのバージョンをアップロードします。古いフォルダーにのみ存在する未コミットの変更は、ワークスペースから失われます。
- Diversion が古いフォルダーのワークスペース設定を削除できなかった場合は、確認メッセージにその旨が表示されます。その場合でも、古いフォルダーは同期されません。
再クローンなしでフォルダー名を変更する
以下の手順で、再クローンなしでフォルダー名を変更できます: 例で使用するワークスペースはこちらです:
1
エージェントを停止する:
システムトレイの Diversion アイコンを右クリックして Quit を選択するか、タスクマネージャーで dv.exe タスクを終了します。オプション a:
2
フォルダーの名前を変更する:
ファイルエクスプローラで直接フォルダー名を変更します。
3
エージェントを再起動する:
コマンドラインで dv コマンドを実行し、正常に起動することを確認します。または、デスクトップアプリを開き、プロンプトが表示されたら「start agent」をクリックします。オプション a:
4
ワークスペースを再アタッチする:
フォルダー名が変更されているため、ワークスペースは表示されません。Attach workspace をクリックします。
5
新しいパスに接続する:
新しいフォルダー名のパスに移動し、Connect をクリックします。
