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 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 は高速かつ軽量であるため、各プロジェクトごとにリモート リポジトリを作成し、それをプロジェクトに携わる各ユーザー向けの作業用リポジトリとしてクローン(コピー)する運用に適しています。その後、ユーザーの作業用 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 リポジトリへの リンク参照 を指定します。PCrepo は、リモート リポジトリ URL に対して指定されたローカル エイリアスです。

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

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

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

  Scheduled for Addition および Ahead of Server としてスケジュールされたファイル

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

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

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

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

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

Git リポジトリをクローンする

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

設計で共同作業を行いたい他のユーザーは、リモート Git リポジトリをローカル作業用リポジトリに cloning することでプロジェクトにアクセスできます。リモート Git リポジトリからファイルにアクセスする方法は社内システムや運用方法によって異なりますが、リモート リポジトリの内容をローカル作業用リポジトリにクローンする基本的な方法は、以下の画像に示すように 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. リポジトリをクローンして、ローカルの作業用 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