設定のエクスポートおよびインポート

ワークスペース間で組織設定をポータブルなバンドルとして移行でき、シークレットは移動しません。

組織設定はポータブルなバンドルとしてエクスポートでき、別の組織に適用可能です。該当する項目は「設定 → データ → 設定をエクスポート」にあります。設定 → データ → 設定をエクスポート.

この機能が利用されるケースは3つあります。既存の組織と同じ設定を持つ新しい組織を作成する場合、試用版ワークスペースの設定を本番環境に反映する場合、およびワークスペースの設定内容を履歴として残す場合です。

移行される内容

このバンドルには組織レベルの設定が含まれます。

カテゴリ	含まれる内容
ポリシーと品質	組織ポリシー、品質ポリシー、プロジェクトゲート、ライフサイクルポリシー、レビュールール
エージェントとモデル	AIプロファイル、プロバイダーキー参照情報
自動化	フック、スケジュール
接続	ソースコントロール連携、チャネルブリッジ、MCPサーバー
アクセス	エンタープライズID設定、サービスアカウント
データ	データ保持、ストレージ設定、監査先

**シークレットは決して移行されません。**プロバイダーキー、トークン、認証情報はプレースホルダーとしてエクスポートされます。バンドルにはそれらキーが存在し、何がそれを使用しているかのみが記録され、値自体は含まれません。インポート後は改めてシークレットを入力する必要があります。

除外されるのは、設定ではなくワークスペースの識別情報（組織名、メンバー、請求関係）や、タスク、実行履歴、監査イベントなどの運用履歴です。

ルールとして、バンドルはワークスペースがどのように設定されているかを示すものであり、その中で何が起きたかについては記述しません。

バンドルを適用する際にはまずプレビューが実行され、各セクションで行われる処理が表示されます。

プレビュー内容を必ず確認してください。needsRebind最も重要なのは「依存関係」項目です。これはターゲット環境に同一のものが存在しない設定、主にリポジトリ接続やシークレットを指します。設定が完全に同等になる前にこれらの項目に対応する必要があります。

エクスポートされたバンドルはファイル形式のため、リポジトリに格納したり差分を確認したりレビューしたりできます。設定をコードとして扱うチームにとって、組織ポリシーの変更が単なるクリック操作ではなくレビュー可能な差分となる点が大きなメリットです。

シークレットはプレースホルダーであるため、バンドルをコミットしても問題ありません。ただし、公開する前に自身の設定に該当する情報が含まれていないか確認してください。