Altium Concord Pro のインストールには、Version Control サービスにより、ローカライズされた(かつ集中管理された)バージョン管理機能が用意されています。このサービスにより、必要な場所であるローカル環境で、検索したり外部の VCS 管理ソフトウェアに費用を支払ったりすることなく、バージョン管理を行えます。
このように集中管理の形で design repositories を定義することで、組織は設計者がアクセスして使用できるリポジトリを完全に制御できます。
Relevance of the information on this page:
Altium Concord Pro を新規インストールすると、管理対象の設計プロジェクトすべてを収容するための Git ベースの設計リポジトリが 1 つだけ提供されます――それだけです。これにより、Concord Pro のローカル Version Control サービスに関するセットアップや複雑さを回避できます。設計リポジトリは 1 つ――Versioned Storage ――で、すべての設計者がアクセスし、リリース先として使用します。そのため、Concord Pro のブラウザー・インターフェースの VCS ページは純粋に情報表示のみとなります。新しいリポジトリを追加することはできず、単一の Git リポジトリは一切変更できず、削除もできません。したがって、このページの情報はあなたには適用されません。
Altium Vault 3.0 から Altium Concord Pro にアップグレードした場合は、SVN リポジトリの使用も有効になり、従来の(確立された)設計フローを継続して利用できます。この場合、ローカル Version Control サービス(SVN のみ)を通じてリポジトリを作成し続けることも、外部リポジトリ(SVN または Git)に接続することもできます。したがって、このページの情報は引き続き有効です。
Important: それ以外の場合、
ボタンはグレーアウトされ、リポジトリの作成/追加はできません。
► 追加情報を見る。
主な利点
この集中管理された Version Control サービスを使用する主な利点は 2 つあります。
-
Altium Concord Pro と SVN の両方で、共通のユーザーおよび権限管理を利用できます。Altium Concord Pro にサインインすると、Version Control サービスはそのセッション/資格情報で動作します。
-
Altium Concord Pro(Concord Pro のブラウザー・インターフェースの VCS ページ(Admin – VCS))で定義したリポジトリは、ログイン時にクライアントへ自動的に反映されるため、ユーザーは URL、プロトコル、パスワードなどを気にする必要がありません。サーバー側で一度設定すれば、必要に応じて対象ユーザーへ共有されます。
Altium Concord Pro の新規ユーザーを作成すると、そのユーザーに定義された Password は Concord Pro と SVN サービスの両方に保存されます。後者は前者からパスワードへ直接アクセスできないためです。
リポジトリの作成
リポジトリはローカル Version Control サービス(SVN のみ)を通じて作成するか、外部リポジトリ(SVN または Git)へ接続できます。すべてのリポジトリは、Concord Pro のブラウザー・インターフェースの VCS ページ(Admin – VCS)で、次の観点から集中管理されます。
-
表示名、説明、リポジトリ・パス。
-
アクセス可否の設定――どのユーザーがアクセスできるか(ローカル Version Control サービスで定義したリポジトリの場合はロール)。
-
利用可否――設計者が個別にリポジトリを作成して接続するのではなく、中央で追加/削除できます。
ユーザーが Altium Concord Pro にサインインすると、そのユーザーが利用可能な Design Repositories は Preferences ダイアログ の Data Management – Design Repositories page に自動的に追加されます。
リポジトリは、ローカル Version Control サービスを使用して Altium Concord Pro インストール内に内部リポジトリとして定義することも、Altium Designer 内蔵の SVN、またはサードパーティの SVN/Git サービスを使用して外部リポジトリとして利用することもできます。アクセス制御は Concord Pro のブラウザー・インターフェースの VCS page で行います。
リポジトリの追加
Design Repository を追加するには、ページ右上にある
ボタンをクリックします。Add Repository ウィンドウが表示されるので、ここでリポジトリを定義します。
ローカル Version Control サービスで作成できるのは SVN タイプのリポジトリのみです。既存(外部)のリポジトリへリンクすることもでき、その場合は SVN または Git のいずれでも構いません。
必要なプロパティは、ローカル Version Control サービスで新規リポジトリを作成するのか、既存の外部リポジトリへリンクするのかによって異なります。
-
New – リポジトリ名と説明を指定するだけです。
-
Existing – 名前と説明に加えて、リポジトリへの URL と、そのリポジトリへアクセスするための資格情報(必要な場合は User Name、Password)を指定する必要があります。
Altium Concord Pro 内部のリポジトリを作成する場合、名前は先頭が英数字で始まり、A-Z、a-z、0-9 を含めることができます。名前の途中にはアンダースコア、ダッシュ、スペースを使用できます。次の単語は使用できません:AUX、COM1-COM9、LPT1-LPT9、CON、NUL、PRN。外部リポジトリには命名制限はありません。
Altium Concord Pro のローカル Version Control サービスを通じて新しい SVN ベースの Design Repository を作成するか、Altium Concord Pro の外部で作成された既存のリポジトリ(SVN または Git)へリンクします。
リンクされた外部 Design Repository は、リポジトリ一覧で External プロパティにチェックが入っている(
)ことで区別されます。
後から Design Repository のプロパティを編集するには、関連する Edit コントロール(
)をクリックします。Design Repository を削除するには、関連する Remove コントロール(
)をクリックします。
既定の Git リポジトリ――Versioned Storage――は一切変更できず、削除もできない点に注意してください。
リポジトリの共有
Design Repositories を集中管理したら、特定のリポジトリへのアクセスが必要なユーザー――基板設計に取り組む設計者を含む――がアクセスできるようにする必要があります。これは、そのリポジトリを共有する、つまりアクセス権限を管理することで実現します。これを行うには、リポジトリに関連付けられた Share コントロール(
)をクリックします。
Manage Permissions ウィンドウが表示され、リポジトリを他のユーザーと共有するために必要なコントロールがすべて用意されています。
Design Repositories を中央で整理している場合、共有は各リポジトリの権限を管理するだけで行えます。
注意点:
-
Altium Concord Pro の Version Control サービスで作成したローカル・リポジトリ(外部ではない)の場合、そのリポジトリは既定で、作成者ユーザーおよび Administrators ロールと共有されます。どちらも Read/Write のフルアクセス権を持ちます。
-
外部リポジトリの場合、既定では誰とも共有されません――インターフェースから接続を追加したユーザーであっても同様です。
-
定義済みの Altium Concord Pro ロール、または全員(その Concord Pro インスタンスの全ユーザー)と共有できるのは、ローカル・リポジトリ(外部ではない)のみです。ロールは個別ユーザーの後に一覧表示されます。
-
権限については、Can Write オプションが有効(
)の場合、ユーザー/ロールは Read/Write アクセスになります。このオプションが無効の場合は Read のみです。
Be Aware: 内部設計リポジトリを共有する際の権限設定は、期待どおりに動作していません。内部設計リポジトリ自体をサーバー・ユーザーに Read-only で共有した場合でも、そのユーザーはそのリポジトリ内に NEW の管理対象プロジェクトを作成でき、作成された対応するプロジェクト・フォルダーに対してフルの Read/Write 権限を取得してしまいます。この誤動作は、そのユーザーが作成した新規の管理対象プロジェクトとそのフォルダーにのみ適用されます。ユーザーは、リポジトリ内の他のフォルダーに対する Write 権限は持ちません。
-
既存のユーザー/ロールの共有アクセスを削除するには、関連する Remove コントロール(
)をクリックします。
Sharing a Local Repository with an Altium Concord Pro User
ローカル(外部ではない)リポジトリを別の Altium Concord Pro ユーザーと共有するには:
-
Manage Permissions ウィンドウで Add User コントロールをクリックします。
-
表示される Add Users ウィンドウで、Select Users to be added フィールドに Altium Concord Pro ユーザーの氏名、ユーザー名、またはメールアドレスを入力し始めると、一致するユーザーの一覧がポップアップ表示されます。この一覧から必要なユーザーを選択します。複数ユーザーを選択できます。ユーザーを削除するには、名前のいちばん右にある削除用の×をクリックします。
-
Permission フィールドでユーザーの権限を設定します。ドロップダウンから Read access または Read/Write access を選択します。
-
準備ができたら
ボタンをクリックしてユーザーを追加し、Manage Permissions ウィンドウに戻ります。
-
Manage Permissions ウィンドウで
ボタンをクリックします。
既存ユーザーの権限を編集するには、Manage Permissions ウィンドウの Can Write オプションを使用し、Read/Write(有効)と Read-only(無効)を切り替えます。
Sharing a Local Repository with a defined Role Group
リポジトリが外部リポジトリではなくローカル Version Control サービスで作成されている場合は、Altium Concord Pro インストールで定義されたロール(ユーザーのグループ)と共有することもできます。ローカル(外部ではない)リポジトリを別のロール・グループと共有するには:
-
Manage Permissions ウィンドウで Add Group コントロールをクリックします。
-
表示される Add Groups ウィンドウで、Select Groups to be added フィールドにロール・グループ名を入力し始めると、一致するロールの一覧がポップアップ表示されます。この一覧から必要なロールを選択します。複数ロールを選択できます。ロールを削除するには、名前のいちばん右にある削除用の×をクリックします。
-
Permission フィールドでロール・グループの権限を設定します。ドロップダウンから Read access または Read/Write access を選択します。
-
準備ができたら
ボタンをクリックしてロールを追加し、Manage Permissions ウィンドウに戻ります。
-
Manage Permissions ウィンドウで
ボタンをクリックします。
既存のロールの権限を編集するには、Manage PermissionsウィンドウのCan Writeオプションを使用し、読み取り/書き込みアクセス(有効)と読み取り専用アクセス(無効)を切り替えます。
Sharing a Local Repository with All Users
リポジトリが外部リポジトリではなくローカルのVersion Controlサービスを通じて作成されている場合、そのリポジトリを「誰とでも」共有することもできます。これにより、すべてのAltium Concord Proユーザーがアクセスして利用できるようになります。サーバーにサインインできる人なら誰とでもローカル(外部ではない)リポジトリを共有するには、次の手順を行います。
-
Manage PermissionsウィンドウのAdd Anyone コントロールをクリックします。
-
Anyoneエントリが共有エンティティのリストに直接追加され、読み取り/書き込みアクセスで自動的に共有されます。
-
Manage Permissionsウィンドウの
ボタンをクリックします。
Anyoneエンティティの権限を編集するには、Manage PermissionsウィンドウのCan Writeオプションを使用し、読み取り/書き込みアクセス(有効)と読み取り専用アクセス(無効)を切り替えます。
Sharing an External Repository with an Altium Concord Pro User
外部リポジトリをAltium Concord Proユーザーと共有するには、次の手順を行います。
-
Manage PermissionsウィンドウのAdd User コントロールをクリックします。
-
表示されるAdd Usersウィンドウで、Select Users to be addedフィールドにAltium Concord Proユーザーのフルネーム、ユーザー名、またはメールアドレスを入力し始めると、一致するユーザーのリストがポップアップ表示されます。そのリストから必要なユーザーを選択します。ユーザーを削除するには、名前のいちばん右にある削除用の×をクリックします。
SVN Userフィールドには、外部リポジトリ(SVNまたはGit)に登録されており、したがってアクセス権を持つ名前を入力します。通常は、リポジトリに登録されているユーザーの一致する名前になります。
-
ボタンをクリックしてユーザー追加を確定し、Manage Permissionsウィンドウに戻ります。上記手順2の要領でさらにユーザーを追加するには、Add Userをクリックします。なお、下の2つ目の例の画像では、ユーザーBarryは一般的なServerAdmin名ではなく、リポジトリ上の一致する名前BarrySmithを使用するように設定されています。
アクセスを提供するために、Concord Proユーザーは外部SVNユーザーにマッピングされます。
-
Manage Permissionsウィンドウの
ボタンをクリックします。
Altium Concord Proユーザーは、外部SVNリポジトリ内の任意の有効なユーザー名にマッピングでき、複数のAltium Concord Proユーザーを外部SVNリポジトリ内の単一ユーザー名にマッピングすることも可能です。
-
アクセス自体(読み取り専用、または読み取り/書き込みのいずれか)は、最終的には外部リポジトリのインストール側で決定されます。Concord Proサーバーは外部リポジトリのユーザー認可に影響を与えないため、サーバー側からこれらの権限を管理することはできません。
-
新規プロジェクト作成時などにAltium Designerからサーバーの外部リポジトリへアクセスする際、以前に設定していない場合はリポジトリ接続の資格情報の入力を求められることがあります。これらの資格情報は、その後このリポジトリに対する操作で自動的に使用されます。
ローカルSVN設計リポジトリへの外部アクセス
ローカルVersion Control Serviceを通じて作成されたSVN設計リポジトリは、TortoiseSVNなどのSVNクライアントでアクセスできます。アクセスには通常のネットワークプロトコル(svn)を使用します。正しいリポジトリアドレスのパスは、次の2か所からコピーできます。
-
Altium Concord ProのブラウザーインターフェースのVCSページ—対象リポジトリのRepository Pathフィールド内。
アドレスは、Altium Concord Proがインストールされている同じマシンからリポジトリにアクセスするか(例:svn://127.0.0.1/<RepositoryName>、またはsvn://localhost/<RepositoryName>)、リモートPCからアクセスするか(例:svn://<ComputerName>/<RepositoryName>。ここでComputerNameはAltium Concord Proが稼働しているPC名)によって異なります。
取得したアドレスをSubversionクライアントのリポジトリ参照機能で使用します。Altium Concord Proでユーザーが作成されると、その資格情報はサーバー本体とVersion Controlサービスの両方で使用されます。サービス側にパスワードが保存されている(SVNクライアントで認証情報を保存している)場合、リポジトリへのアクセスは即時に行えます。パスワードが保存されていない場合は、中間のAuthenticationダイアログが表示されます。ユーザー資格情報を入力し、OKをクリックしてリポジトリにアクセスします。詳細は下記のServer & VCS User Synchronizationを参照してください。
Altium Concord ProインストールのローカルSVNベースVersion Controlサービスで作成された設計リポジトリの内容を参照しているところ。
ローカルVersion Controlサービスで作成された設計リポジトリは、(Altium Concord Proのデフォルトインストールでは)内部データが\ProgramData\Altium\ConcordProData\Repositoryフォルダー内の対応するサブフォルダーに保存されます。このフォルダーには、保守のためのIT担当者以外は、いかなる方法でも直接アクセスしないでください。
Server & VCS User Synchronization
Altium Concord Proの新規ユーザーが作成されると、そのユーザーに定義された資格情報(User NameおよびPassword)は、サーバーのデータベースとVersion Controlサービスの両方に保存されます。これは、後者が前者からパスワードを直接参照できないためです。パスワードはVersion Controlサービス側ではプレーンテキスト形式(\ProgramData\Altium\ConcordProData\Repository\passwdファイル内)で保存されます。
このリスト内のエントリにより、Altium Designerを通じてサービスを利用する際にConcord ProのSVNリポジトリへアクセスできます。たとえば、最初のSVNリポジトリが作成された時点でConcord Proユーザーがすでに存在していた場合(通常とは逆の順序)など、ユーザーの資格情報がファイルに含まれないことがあります。これは、passwdファイルにそれらの名前/パスワードの組み合わせを手動で追加するか、Concord Proで各ユーザープロファイルのパスワードを再入力することで対処できます。後者の方法では、サーバーPCへ直接アクセスすることなく、passwdファイルが適切に作成(反映)されます。
Altium Concord Proのデフォルトインストールでは、Version Controlサービス用のユーザー資格情報は関連するpasswdファイルに保存されます。
リポジトリの削除
Altium Concord ProのVersion Controlサービスからリポジトリを削除するには、Concord ProのブラウザーインターフェースのVCSページで、そのリポジトリに関連付けられたRemoveコントロール(
)をクリックします。
外部リポジトリは、プロジェクトが含まれているかどうかに関係なく削除(切断)できます。一方、ローカルリポジトリ(Altium Concord ProのVersion Controlサービスで内部的に作成されたもの)は、1つ以上のプロジェクトが含まれている場合は削除できません。その旨が通知されるため、削除を進める前にまずプロジェクトを削除してください。
それでも、ローカルリポジトリにプロジェクトが存在しない場合、実際に削除されるのではなく、アーカイブディレクトリ(Altium Concord Proのデフォルトインストールでは\ProgramData\Altium\ConcordProData\RepositoryDumps)へ移動されます。リポジトリはDumpファイル内に、<UniqueID>_<ProjectName>.dump形式(例:775f6c22-b9a1-468c-9f1f-4f217bb3be6b_Central Design Repository.dump)で格納されます。