Pipelineでのメタデータ移行と標準ツール代替
この記事は2024年に書いたものです。取り上げているPipelineは個人開発の無償ツールで、GitHub上の更新は2019年で止まっています。当時の手順はそのまま残し、いまの更新状況と標準ツールでの代替を追記しました。
この記事の読み方
最初に書いた時点では、GitHubで配布されている無償デスクトップアプリ「Pipeline」を使い、移行元・移行先のSalesforce組織を接続してカスタム項目などのメタデータを移行する、という内容でした。その手順自体は下に残してあります。
Pipelineでできたこと
Pipelineは、Git連携も含めて複数のSalesforce組織間でメタデータを移行できる、GUI操作の無償デスクトップアプリでした。導入から移行確認までは、次の流れで進みます。
インストーラをダウンロードして導入する
GitHubのリリースページから
Pipeline-x.x.x-setup.exeをダウンロードし、Windows環境にインストールします。移行元・移行先の組織を接続として登録する
「New Connection」から、移行元組織と移行先組織それぞれのSalesforce接続を作成し、登録済みの一覧から選択できるようにします。
Pipelineを作成して移行対象を選ぶ
CONNECTION(FROM)とCONNECTION(TO)に組織を指定し、Pipeline名を付けます。Run Test を False にしたうえで、Entity Type(今回はカスタム項目)と、移行したい項目の型(テキストエリア、ロングテキストエリアなど)を選びます。
Pipelineを実行する
「Run Pipeline」ボタンを押すと、選んだメタデータが移行先組織へデプロイされます。
移行先組織で反映を確認する
移行先組織にログインし、対象のカスタム項目が実際に作成・反映されているかを確認します。
⚠️ 移行できるのはメタデータ(カスタム項目などの設定)で、レコードのデータそのものは対象外です。
2026年9月時点の状況
Pipelineは、GitHubリポジトリ(xgeek-net/pipeline)で公開されたままですが、更新は止まっています。コミット履歴を確認すると、最新リリースv2.0.4に対応するコミット「Fix git reset delay bug」は2019年8月15日で、これ以降mainブランチへの新しいコミットもリリースも公開されていません。開発元の製品紹介ページ(xgeek.net)も、ページ内の更新日情報が2019年6月18日を最後に変わっていません。
⚠️ リポジトリ自体はアーカイブされておらず、提供終了の告知も見当たりません。一方で、開発者(xgeek)自身は2026年になっても別のSalesforce向けツールを新しく公開しており、開発が完全に止まった会社・個人というわけではありません。Pipelineという製品単体の更新が止まっているように見える、というのがここで確認できる事実です。
導入前に確かめること
最終更新日を必ず見る
GitHubのリリースページとコミット履歴で、最後に手が入った日付を確認します。数年単位で止まっている場合は、いまの組織のAPIバージョンやメタデータ形式に対応しているとは限りません。
個人開発のツールであることを踏まえる
サポート窓口や保守契約がある製品ではありません。動かなくなったときの代替手段を、先に決めておきます。
標準ツールで足りないかを確認する
組織間のメタデータ移行だけが目的なら、変更セットやSalesforce CLIといった標準の仕組みで足りることがほとんどです。
標準ツールで同じことをする
| やりたいこと | 標準でのやり方 |
|---|---|
| サンドボックスから本番へメタデータをデプロイする | 変更セット。Setupの「Outbound Change Sets」からデプロイ接続を張った組織へ送ります |
| コマンドラインでメタデータをデプロイ・取得する | Salesforce CLI(sfコマンド)のsf project deploy start・sf project retrieve start |
| プログラムからメタデータを取得・配置する | Metadata APIのretrieve・deploy呼び出し |
| 複数組織へ繰り返し配布できる単位でまとめる | アンロック済みパッケージとしてメタデータをまとめ、パッケージ単位でインストールします |
| Gitリポジトリを軸にした承認・リリースの流れを組む | DevOps Center。ソース管理を単一の情報源にして、パイプラインの段階を経てプロモーションします |
sf project deploy start --source-dir force-app --target-org my-sandbox --dry-run sf project deploy start --source-dir force-app --target-org my-sandbox
ソース形式のメタデータを対象組織へデプロイするコマンドです。dry-runで検証してから本実行します。
⚠️ 変更セットは、Setupメニューを通じて行える設定変更だけが対象です。レコードのデータは含められません。
ここで間違えやすい
| 間違い | 何が起きるか |
|---|---|
| 変更セットでレコードのデータも移せると思い込む | 変更セットの対象はメタデータだけです。データはデータローダなど別の手段が必要です |
| カスタム項目だけを選び、関連するメタデータを含め忘れる | 依存関係のあるコンポーネントが足りず、デプロイが失敗します。package.xmlに依存先も含めます |
| 更新の止まったツールをそのまま導入判断する | 現在のAPIバージョンやメタデータ形式に対応していない可能性があります。最終更新日を先に確認します |
sf project deploy startをdry-runなしでいきなり本番実行する | 想定外のコンポーネントまで一緒にデプロイされることがあります。--dry-runで検証してから実行します |
確認した環境
- 2026年9月/Salesforce Summer '26(APIバージョン67.0)時点で、変更セット・Salesforce CLI・Metadata API・アンロック済みパッケージ・DevOps Centerの公式ドキュメントで確認しています
- Pipelineの更新状況は、2026年9月にGitHubリポジトリ(xgeek-net/pipeline)のコミット・リリース履歴、および配布元サイトxgeek.netの掲載内容で確認しています
- 記事の前半の手順は2024年4月時点の記録です。画面や操作は変わっている可能性があります
まとめ
- Pipelineは、移行元・移行先の組織をGUIで接続し、カスタム項目などのメタデータを移行する無償ツールでした
- GitHub上の最終コミット・リリースは2019年8月です。提供終了の告知はありませんが、7年以上目立った更新がありません
- 組織間のメタデータ移行は、変更セット・Salesforce CLI・Metadata API・アンロック済みパッケージ・DevOps Centerといった標準の仕組みで代替できます
- コマンドラインで扱うなら
sf project deploy startが入り口です - 継続的なリリース管理をチームで回すなら、DevOps Centerの導入を検討してください
Salesforceの導入・運用についてご相談ください
導入前の検討から、お使いの環境の改修・運用、AIとの連携まで承ります。状況を伺ったうえで、進め方をご提案します。