プロジェクトのインポート

ユーザーアカウント

TeamCity ユーザーには一意のユーザー名が必要です。そのため、ユーザーがインポートスコープ内にある場合、TeamCity はユーザー名を比較して各ユーザーがインポートされるかマージされるかを確認します。 どちらの場合も、ユーザー関連データ (個人ビルド、変更、テストミュート、調査) と ユーザーアカウント設定 - ロール、権限、VCS 名、通知設定など - を、システム全体およびインポートされたプロジェクトに関連するものの両方で転送します。

• ユーザー名がターゲットサーバーにとって新しいユーザーは、 インポート済み されます。 このようなユーザーは、ターゲットサーバー上で インポート済み <インポート日時>とマークされた別のグループに表示されます。

• ユーザー名が両方のサーバーに存在するユーザーは、 マージ済み できます。 既存のデータはそのまま残り、ターゲットにとって新しいデータのみが追加されます。

マージはユーザー名に基づくため、同じユーザー名が両方のサーバーで別々の人に属している場合でも、その情報はマージされます。 マージによって、ターゲットサーバー上のユーザー権限が拡張されることもあります。ソースサーバーで付与されたシステム管理者ロールはターゲットユーザーに追加されますが、プロジェクトロールはインポートスコープ内のプロジェクトに対してのみ追加されます。

プロジェクトのインポート | インポートスコープ | ユーザー セクションには、見つかった競合する項目の数が表示されるため、それらを確認してマージするかどうかを判断できます。 TeamCity は、両方のサーバーで同じユーザー名だがメールアドレスが異なるユーザーを一覧表示し、ユーザー名とメールアドレスの両方を共有するユーザーを数えます。 メール確認 が有効化されている場合、そのようなユーザーは確認済みメールアドレスに基づいて比較されます。 これらのオプションは、確認済みメールアドレスを持つユーザーがソースサーバー、ターゲットサーバー、またはその両方に存在する場合にのみ有効です。

ユーザーグループ

グループも同じように動作します。新しいグループはインポートされ、既存のグループはマージできます。 競合する状態 が発生した場合 - グループが両方のサーバーに存在するがロールが異なる場合 - インポート後にターゲットグループに追加のロールが付与されることがあり、そのすべてのメンバーにも同様に付与されます。

プロジェクトのインポート | インポートスコープ | グループ セクションには、見つかった競合グループの数が表示されます。 グループキーを共有するすべてのグループを表示し、マージするかどうかを決定できます。 「全ユーザー」グループは、デフォルトで各 TeamCity サーバーに存在するため、常に競合として一覧表示されます。

アクセストークン

ユーザーがインポートスコープに含まれる場合、TeamCity がユーザーの アクセストークン を転送するかどうかは、 トークンスコープ によって決まります:

• インポート対象に選択されたプロジェクトに限定されたトークン (プロジェクトごとの制限スコープ) は、デフォルトでインポートされます。 ターゲットサーバーでは、これらのトークンはインポートされたプロジェクトに対してのみ権限を保持します。

• その他のプロジェクトに限定されたトークンはインポートされません。 これには次の影響があります:

  • トークンのスコープがプロジェクト A (インポート済み) とプロジェクト B (インポートされない) に設定されている場合、その権限スコープは A に絞る形になります。

  • トークンのスコープが複数のプロジェクトに設定されていて、そのいずれもインポートされていない場合、そのトークンはまったくインポートされません。

  • インポートされたプロジェクトの親プロジェクトにスコープ設定されたトークンは、TeamCity がこの親プロジェクトが子と共有する設定をインポートする場合でもスキップされます。

• 所有者と同じ権限を付与するトークン (現在のユーザーと同じスコープ) は、明示的な同意がある場合にのみインポートされます。 プロジェクトのインポート | インポートスコープ | ユーザー セクションで対応するチェックボックスを選択してください。 このようなトークンはいずれのプロジェクトにも限定されないため、ターゲットサーバー上では所有者がそこに持つすべての権限を付与します。そのため、デフォルトでは除外されます。

マージされたユーザーの場合、インポートされたトークンは、そのユーザーがターゲットサーバー上ですでに持っているトークンに追加されます。 ユーザーが同じ名前のトークンをすでに持っている場合、一致するインポートされたトークンはスキップされます。