Gitベースのバージョン管理

Git タイプのリポジトリは Altium Designer の外部で作成され、ローカルの作業用 Git リポジトリの内容には、そのホストフォルダーからファイルを開くことでアクセスします。リモートおよびローカルの作業用 Git リポジトリの管理は通常、社内システムや外部の Git ツールを通じて行われ、ファイルレベルの操作(Commit、Push、Update など)は Altium Designer の編集環境で処理されます。

  • Altium Designer で Git バージョン管理機能を利用するには、VCS Provider – Git ソフトウェア拡張機能をインストールする必要があります。 この拡張機能は、デフォルトで Altium Designer とともにインストールされます。 手動でインストールまたは削除することもできます。

    拡張機能の管理の詳細については、Extending Your Installation ページを参照してください(Altium Designer DevelopAltium Designer AgileAltium Designer)。

  • Git リポジトリは Altium Designer の外部で扱われる点に注意してください。

  • Git バージョン管理で作業する際、LFS リポジトリの利用は部分的にサポートされています。注意: Altium Designer は LFS リポジトリでの作業を完全にはサポートしておらず、 場合によってはユーザーデータの損失につながる可能性があります。

    この機能は、VCS.AllowLFSRepos オプションが Advanced Settings dialog で有効になっている場合に利用できます。

  • Git VCS ではさまざまなデータ転送プロトコルが提供されていますが、Altium Designer は現在、ローカル Git リポジトリとそのリモートマスターリポジトリ間の接続については HTTP/HTTPS プロトコルのみをサポートしています。詳細は Protocols を参照してください。
  • 外部 Git VCS 管理下のプロジェクトに変更を Push する際、その設計が格納されているリポジトリが接続に SSH プロトコルを使用している場合は、そのリポジトリ自体がこのプロトコルをサポートしていれば、代わりにサポート対象の HTTPS 接続プロトコルを使用するよう更新を試みるかどうかを選択できます。
  • GitHub でホストされているプロジェクトを Altium Designer から扱う場合は、personal access token を使用する必要がある点に注意してください。そうしないと、プロジェクトをリポジトリに Push する際に認証エラーが表示されます。詳細は Creating a personal access token を参照してください。

Git バージョン管理に追加

分散型バージョン管理システムとして、Git は SVN とは異なるワークフローを使用しますが、Altium Designer で既存のプロジェクトファイルを扱う場合、その違いは最小限です。要するに、Git は単一のリポジトリ対象への依存に重点を置くのではなく、複数のリポジトリ間でのデータ転送を適用します。

► 詳細については Git website を、適用される原則の概要については Version Control Essentials を参照してください。

Git VCS システムは通常、必要に応じて複数の Git リポジトリをホストできる集中管理型のリモート Git サーバーを基盤としています。Git は高速かつ軽量であるため、プロジェクトごとにリモートリポジトリを作成し、それをそのプロジェクトに関わる各ユーザー向けの作業用リポジトリとして clone(コピー)する運用に適しています。ユーザーの作業用 Git リポジトリで更新されたファイルは、その後 Git サーバー上のリモートリポジトリへ「push」され、同期が行われます。

リモートリポジトリは、共有ネットワークリソース上などの便利な場所に置かれた共有タイプ(bare)の Git リポジトリである場合もあります。Git コマンドラインツールで共有リモート Git リポジトリを作成するには、git init --bare コマンドを使用します。

Altium Designer のプロジェクトを Git システム上に構築する方法は、社内インフラや運用方法によって異なり、Altium Designer の外部にある tools やプロセスが関与します。ただし、いったんプロジェクトがバージョン管理システムに登録され、ローカルの作業用リポジトリとして利用可能になれば、Altium Designer で Git VCS を扱うことは、実質的に SVN VCS を扱う場合とほぼ同じです。

プロジェクトを Git に追加する

例として、既存の Altium Designer プロジェクトは、基本的な Git command line tools を使用してローカル Git リポジトリに追加できます。この方法では、プロジェクトフォルダーがローカル(作業用)Git リポジトリとなり、利用可能なリモート Git リポジトリにリンクされ、最終的に更新されます。

ここでは、ツールを使用して次のことを行います。

  1. プロジェクトフォルダー内に作業用 Git リポジトリを作成(initialize)する。
  2. 追加して、プロジェクトファイルを Git バージョン管理下に置く。*.* ファイル指定では、フォルダーではなくファイルが追加されます。
  3. Web サーバー上の共有リモート Git リポジトリへの link reference を指定する。PCrepo は、リモートリポジトリ URL に対して指定されたローカルエイリアスです。

ローカル Git リポジトリに追加されるプロジェクトローカル Git リポジトリに追加されるプロジェクト

以下の Commit および Push の処理もコマンドラインツールで実行できますが、この例では以下に示すように Altium Designer で手順を完了します。

プロジェクトを Altium Designer で開くと、Projects パネルおよび Storage Manager パネル内のファイルのステータスは Scheduled for Addition)になります。その後、作業用リポジトリに Commit すると、ファイルは Ahead of Server ステータス()に変わります。これは、その時点ではまだリモート Git リポジトリでバージョン管理下にないためです。

  追加予定およびサーバーより先行としてスケジュールされたファイル

Push コマンドにより、ローカルリポジトリのファイルがリモート Git サーバーに更新されます。この際、対象リポジトリに対する有効な認証情報の入力を求められる場合がありますが、これは一度だけの処理です。

有効な認証情報の要求後にファイルが更新される有効な認証情報の要求後にファイルが更新される

これで Git バージョン管理下に完全に置かれた Altium Designer プロジェクトは、リモート Git リポジトリを通じて他のユーザーも利用できるようになります。たとえば別のユーザーは、そのリポジトリをローカルマシンに clone し、共同作業のワークフローの中で編集したファイルを最終的にリモートリポジトリへ push できます。

上記のプロセスは、プロジェクトをリモート Git サーバーに追加する方法の単なる手動例である点に注意してください。確立された Git VCS 環境では通常、管理者の管理下で、作業用 VCS プロジェクトの作成や取得を容易にする GUI tools や自動化システムが用意されています。

Altium Workspace は、透過的な VCS 連携を支援する自動化機能を備えた Git リポジトリを使用する、高度なサーバーベースシステムの一例です。

Git リポジトリを clone する

Git バージョン管理に追加されたローカルプロジェクトは、プロジェクトのローカルフォルダー(作業用リポジトリ)から Altium Designer で編集でき、Commit された変更はその後リモート Git リポジトリに更新されます。ローカルリポジトリとリモートリポジトリは VCS の Push コマンドによってリンクされ、最終的に同期されます。

設計で共同作業を行いたい他のユーザーは、リモート Git リポジトリをローカルの作業用リポジトリに cloning することでプロジェクトにアクセスできます。リモート Git リポジトリからファイルにアクセスする方法は社内システムや運用方法によって異なりますが、リモートリポジトリの内容をローカルの作業用リポジトリに clone する基本的な方法は、以下の画像に示すように Git コマンド git clone [remote repository URL] [target working repository folder] を使用することです。

Commit された変更がリモート Git リポジトリに更新されるCommit された変更がリモート Git リポジトリに更新される

このプロセスでは、共有リモートリポジトリがローカルの作業用リポジトリとして複製され、master ブランチの最新(HEAD)リビジョンが自動的にチェックアウトされます。その後、ファイルは Altium Designer で編集、保存、VCS への Commit が可能となり、最終的にリモート Git リポジトリへ push されます。

既存の Git リポジトリに接続する

Altium Designer には、新しい Git リポジトリを作成したり既存のものに接続したりするためのコントロールはありません。ただし、他の手段によってこの種の既存リポジトリに実質的に接続することは可能です(これは Git ユーザーに好まれてきた従来の手法です)。そのためには、次のようにします。

  1. リモート Git リポジトリを作成するか、Altium Designer プロジェクトが保存されている会社の外部リポジトリにアクセスします。
  2. リポジトリを clone して、ローカルの作業用 Git リポジトリを作成します。
  3. ローカルリポジトリから Altium Designer プロジェクトを開きます。

Altium Designer は、そのプロジェクトが Git ベースのリポジトリでバージョン管理されていることを認識し、VCS 関連のステータス、およびファイルを扱うためのコマンド/機能(Commit(ローカル作業用 Git リポジトリへ)や Push(ローカル Git リポジトリからリモート Git リポジトリへ)を含む)を提供します。

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

利用できる機能は、所有する Altium ソリューション (Altium DevelopAltium Agile のエディション (Agile Teams、または Agile Enterprise)、または Altium Designer (有効な期間)) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Content