p4 depot

ディポ仕様を生成または編集します。

構文

p4 [g-opts] depot [-t type] depotname
p4 [g-opts] depot -d [-f] depotname
p4 [g-opts] depot -o [-t type] depotname
p4 [g-opts] depot -i

説明

Helixサーバでは、ファイルをディポと呼ばれる共有リポジトリに格納します。 デフォルトでは、各Helixサーバインストールに1つずつdepotと呼ばれるlocalディポがあります。

ディポを生成または編集するには、p4 depot depotnameコマンドを使用してディポ仕様フォーム内のフィールドを編集します。 ディポのタイプは、local、stream、remote、archive、spec、unload、tangent、graphのいずれかになります。

特定のディポタイプに対して-tオプションを指定すると、そのディポタイプ用のディポ仕様が作成されます。 以下に例を示します。

$ p4 depot -o -t stream] mystreamdepot

上記のように指定すると、以下のディポ仕様が作成されます。

Depot:        mystreamdepot
Owner:        user
Date:         2018/12/21 15:57:50
Description:  Created by user.
Type:         stream
StreamDepth:  //mystreamdepot/1
Map:          mystreamdepot/...

この仕様は編集することができます (StreamDepthの編集方法については、ストリームディポを使用するを参照してください)。

または、以下のように指定して、出力ストリームをp4 depotコマンドに接続することもできます。

$ p4 depot -o [-t stream] mystreamdepot | p4 depot -i

フォームフィールド

オプション

使用上の留意点

マップ情報を提供する

ローカルディポでは、ディポにあるファイルのアーカイブ内容のファイルシステムの位置をMapフィールドで指定します。 位置は、相対位置または絶対位置のいずれかになります。 ディポのバージョン化ファイルを別のボリュームやドライブに保存するには、Mapフィールドに絶対パスを指定してください。 指定するパスは、P4ROOTの下にある必要はありません。

• 例えば/p4/depots/depot/...のような絶対位置の場合、それ以上の解釈は必要ありません。

• 相対位置、例えばAce/...などの場合、server.depot.root構成可能変数が設定されていない限り、位置はP4ROOTの値に相対すると解釈されます。

  既存のインストールにアドレスのserver.depot.rootフォームを導入するように注意してください。 P4ROOT以外の値に設定する場合、まず既存のディポのMapの値を更新して、それらが絶対値であることを確認してください。 server.depot.root変数を設定しても、何かの妨げになることはありません。 その後戻ってから、要望に応じて既存のディポマップを更新します。

リモートディポを使用する

remoteディポを使用している場合、Perforceサービスをホスティングするマシン(すなわち、P4PORTで指定されたマシン)の設定により、Helixサーバアプリケーションが別のPerforceサービスからファイルを読み取る権限が与えられています。 リモートディポの使用は読み取り専用アクセスに限られます。つまり、Helixサーバアプリケーションは、他のサーバ上のディポにあるファイルをadd、edit、delete、またはintegrateすることはできません。 リモートディポの詳細については、「Helix Coreサーバ管理者ガイド」を参照してください。

リモートディポはremoteという仮想ユーザによって(または、リクエストの送信元となったサービスに対してサービスユーザが設定されていればそのユーザによって)アクセスされます。また、デフォルトでは、どのHelixサーバインストール上のどのファイルもリモートからアクセスできるようになっています。 特定のサーバへのリモートアクセスを制限もしくは排除するには、p4 protectを用いて、そのサーバのユーザremote(またはアクセス対象サイトのサービスユーザ)に与える権限を設定します。

例えば、ある特定のサーバ上のすべてのディポに保存されたすべてのファイルに対するremoteアクセスを排除するには、そのサーバに関する権限を次のように設定します。

read user remote * -//...

リモートディポはreadアクセス専用であるため、writeまたはsuperのアクセス権限を解除する必要はありません。

サービスユーザも仮想ユーザremoteもHelixサーバのライセンスを必要としません。

お使いのサーバでサービスユーザによってリモートディポにアクセスする場合は、サービスユーザにリモートディポ提供元のサーバに対する有効なチケットが与えられている必要があります。

詳しくは、『Helix Coreサーバ管理者ガイド』の「リモートディポとマルチサーバ開発」を参照してください。

スペックディポを使用する

specディポが存在する場合、ユーザが編集したフォーム(クライアントワークスペースの仕様、ジョブ、ブランチマッピングなど)に対する変更が追跡されます。 specディポは1つのサーバに対して1つしか作成できません。 スペックディポにあるファイルは自動的にHelixサーバによって生成され、Helixサーバシンタックスは次のように表記されます。

//specdepotname/formtype/objectname[suffix]

例えば以下のように指定すると、job000123に対する変更履歴を取得することができます。「spec」はスペックディポの名前、「.p4s」はデフォルトの拡張子です。

p4 filelog //spec/job/job000123.p4s

スペックディポを作成したら、「p4 admin updatespecdepot」コマンドを使用して、現在のクライアントフォーム、ディポフォーム、ブランチフォーム、ラベルフォーム、タイプマップフォーム、グループフォーム、ユーザフォーム、ジョブフォームのデータをまとめてスペックディポに読み込みます。

スペックディポの場合、SpecMap:フィールドを使用して、どのスペックをバージョン化するかを制御できます。 デフォルトでは、すべてのスペック (//spec/...)がバージョン化されます。 プロテクションテーブルをバージョン化の対象から外すには、スペックディポのSpecMap:を次のように設定します。

SpecMap:
    //spec/...
    -//spec/protect/...

スペックマッピングの追加または変更は、スペックディポの今後の更新に対してのみ影響します。スペックディポに既に格納済みのファイルには影響しません。

詳細については、『Helix Coreサーバ管理者ガイド』の「スペックディポ」を参照してください。

ストリームディポを使用する

ストリームとは、階層とポリシーが含まれている特殊なブランチのことです。 streamディポは、一連のストリームを保管するためのコンテナです。 ストリームディポを作成するには、ディポ仕様で以下の情報を指定します。

• Depot: ストリームディポの名前
• Owner
• Date: ストリームディポの作成日
• Type: ストリームディポのタイプ (「stream」を指定する必要があります)
• StreamDepth

StreamDepthについて

デフォルトの場合、ストリーム内のファイルはディポ名の1レベル下の階層に保管されます。 以下に例を示します。

//myStreamDepot/myStream1
//myStreamDepot/myStream2
//myStreamDepot/myStream3

デフォルト値以外の値を「StreamDepth:」フィールドで指定する場合は、整数またはスラッシュを指定します。

Depot:	myStreamDepot Owner:	bruno Date:	2018/11/21 11:10:32 Description: Created by bruno. Type:	stream Address: local Suffix: .p4s StreamDepth: 2

Depot:	myStreamDepot Owner:	bruno Date:	2018/11/21 11:10:32 Description: Created by bruno. Type:	stream Address: local Suffix: .p4s StreamDepth: //myStreamDepot/foo/bar

//myStream/organization/project/mainline
//myStream/organization/project/dev
//myStream/organization/project/release1
//myStream/organization/project/release2

グラフタイプのディポを使用する

GitリポジトリをHelixサーバに保存するには、graphタイプのディポを使用します。

例えば、タイプgraphのディポを作成しgraphDepot1という名前を付け、次のコマンドを発行します。

p4 depot -t graph graphDepot1

タイプgraphのディポのリストを表示するには、次のコマンドを発行します。

p4 depots -t graph

repoという名前のグラフタイプのデフォルトのディポが、Helixサーバサーバが作成されたとき、または2017.1以降に更新されたときに、自動的に作成されます。

Gitリポジトリまたはグラフディポを作成後、p4 depotsは、graphタイプであるかどうかに関わらず、すべてのディポをリストします。

graphタイプのディポでの作業についての詳細は、『Helix4Git管理者ガイド』を参照してください。

関連コマンド