Local Version Control Service with Altium Concord Pro

This document is no longer available beyond version 5.0. Information can now be found here: Local Version Control Service with Altium On-Prem Enterprise Server for version 7.1

This documentation page references Altium Concord Pro, which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

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: それ以外の場合、  ボタンはグレーアウトされ、リポジトリの作成/追加はできません。

追加情報を見る

Design Repositories の詳細と、Altium Designer からそれらを扱う方法については、Using External Version Control を参照してください。

主な利点

この集中管理された Version Control サービスを使用する主な利点は 2 つあります。

  1. Altium Concord Pro と SVN の両方で、共通のユーザーおよび権限管理を利用できます。Altium Concord Pro にサインインすると、Version Control サービスはそのセッション/資格情報で動作します。
  2. 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 で行います。 リポジトリは、ローカル 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 NamePassword)を指定する必要があります。
Altium Concord Pro 内部のリポジトリを作成する場合、名前は先頭が英数字で始まり、A-Z、a-z、0-9 を含めることができます。名前の途中にはアンダースコア、ダッシュ、スペースを使用できます。次の単語は使用できません:AUXCOM1-COM9LPT1-LPT9CONNULPRN。外部リポジトリには命名制限はありません。

Altium Concord Pro のローカル Version Control サービスを通じて新しい SVN ベースの Design Repository を作成するか、Altium Concord Pro の外部で作成された既存のリポジトリ(SVN または Git)へリンクします。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 を中央で整理している場合、共有は各リポジトリの権限を管理するだけで行えます。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 コントロール()をクリックします。

ローカル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サービスで作成された設計リポジトリの内容を参照しているところ。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サービス用のユーザー資格情報は関連するpasswdファイルに保存されます。

リポジトリの削除

Altium Concord ProのVersion Controlサービスからリポジトリを削除するには、Concord ProのブラウザーインターフェースのVCSページで、そのリポジトリに関連付けられたRemoveコントロール()をクリックします。

PreferencesダイアログData Management – Design Repositories pageからリポジトリを削除しても、そのAltium Designerインスタンスでそのリポジトリを使用しないようにするだけであり、Altium Concord ProのVersion Controlサービスからリポジトリ自体が削除されるわけではありません。Altium Concord Proからサインアウトして再度サインインすると、そのAltium Designerインスタンスで利用可能なリポジトリ一覧に再び表示されます。

外部リポジトリは、プロジェクトが含まれているかどうかに関係なく削除(切断)できます。一方、ローカルリポジトリ(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)で格納されます。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Content