このガイドでは、Jira または Confluence Server (または Data Center) からクラウドにユーザーを移行するために最適な方法の概要について説明します。

ユーザーとグループをインポートする最適な方法は、次の内容によって決まります。  

• どの製品を移行しているか、および外部ディレクトリからのユーザーかどうか
• どの移行方法を使用しているか
• If you plan to use Atlassian Access for SCIM (user provisioning)

はじめる前に

ユーザーの移行方法を決定する前に、以下を確認する必要があります。

• クラウドおよびサーバー製品でのユーザー管理と、クラウドで必要なユーザー管理のセットアップのドキュメントをお読みください。

• Jira または Confluence Cloud Migration Assistant を使用して移行する予定の場合、ユーザー、グループ、および権限の移行方法を確認します。

• Read the section on Atlassian Access recommendations if you plan to use an external identity provider.

Jira ユーザーの移行戦略

移行する Jira 製品、および外部ディレクトリがあるかどうかに応じて、次の表を使用して選択すべき移行方法を決定します。

Jira Cloud Migration Assistant によって、Jira ユーザーを移行する場合

移行アシスタントを使用すると、次のことが実行できます。

• 移行対象として選択したプロジェクトに関連するユーザーを移行する

• プロジェクト データなしで、アクティブな内部および外部ディレクトリからすべてのユーザーを移行する

Jira Cloud Migration Assistant は、ユーザーがプロジェクトで参照されている場合、非アクティブなディレクトリからユーザーを移行します。これらのユーザーは個人情報なしで移行され、Former user として表示されます。

Jira Cloud Migration Assistant creates a new Atlassian account for each user and associates them to your cloud site. They will also be assigned a password, so your users will need to reset their password the first time they sign in. All your users' history and content will be linked to their new Atlassian account. Learn more about migrating users and groups with the Jira Cloud Migration Assistant.

Jira Cloud Migration Assistant を使用してすべてのデータを移行できない場合は、ユーザーのみを移行することを検討してください。たとえば、最初に移行アシスタントを使用してすべての Jira ユーザーを移行してから、Jira サイト インポートを使用してプロジェクトをインポートできます。Jira Cloud Migration Assistant の使用方法についてご確認ください。 

Jira Cloud のサイト インポートで、Jira ユーザーを移行する

Jira Cloud のサイト インポートでは、Jira の内部ディレクトリで管理されているユーザーのみが移行されます。LDAP、ADFS、Crowd などの外部ディレクトリによってユーザーが管理されている場合は、次の内容を実行する必要があります。

• Jira Cloud Migration Assistant を使用します。または

• 外部ディレクトリ ユーザーを Jira と同期します。詳細については、「外部ディレクトリからデータを同期する」をご参照ください。 

次の手順を実行します。

1. Jira Server および Confluence データベースに対して次の SQL クエリを実行し、ユーザーとグループの CSV ファイルを作成します。

ユーザー

SELECT email_address AS "email", user_name AS "username", display_name AS "displayname", active AS "active" FROM cwd_user

グループ

SELECT DISTINCT parent_name AS group, child_name AS username FROM cwd_membership;

     2. Provide Atlassian's migration support team with the two CSV files to have the users and groups imported into Jira Cloud.

Jira サイト インポートの使用方法をご参照ください。

Confluence ユーザーの移行戦略

Confluence ユーザーを移行するには、Confluence Cloud Migration Assistant を使用します。

Confluence Cloud Migration Assistant を使用すると、次のことが可能になります。

• 移行対象として選択したスペースに関連するユーザーを移行する

• スペースを移行せずに、アクティブな内部および外部ディレクトリからすべてのユーザーを移行する

The Confluence Cloud Migration Assistant creates a new Atlassian account for each user and associates them to your cloud site. They will also be assigned a password, so your users will need to reset their password the first time they sign in. All your users' history and content will be linked to their new Atlassian account, and space permissions will remain the same. See the Users and groups section in the Confluence Cloud Migration Assistant page to learn more about migrating users and groups.

Jira と Confluence の両方を移行する

Jira と Confluence の両方を移行する場合、両方の移行アシスタントを使用して、ユーザーを、データより前、またはデータとともに移行することをおすすめします。 

お使いの Jira 製品または外部ディレクトリによっては、Jira Cloud のサイト インポートを使用する必要があります。Jira ユーザー移行戦略をチェックして、どの方法が適しているかを確認してください。サイト インポートを使用する場合、次の問題を回避するために、最初に Jira を移行する必要があります。

•  ACCESS-653 - Migrating from Atlassian Server products where SCIM was enabled to Atlassian Cloud and then using Atlassian Access SCIM causes users to be given GUID usernames IN PROGRESS

上記の最も適した方法を使用してすべての Jira ユーザーとデータを移行してから、Confluence の使用方法とスペースを移行することをおすすめします。

If you plan to use an external identity provider for SCIM user provisioning, we also recommend migrating Jira first. See our Atlassian Access recommendations below for more details.

Atlassian Access recommendations

If you're planning to subscribe to Atlassian Access for advanced user management features, including SAML single sign-on (SSO) and System for Cross-domain Identity Management (SCIM) there are a few recommendations to be aware of.

SAML SSO

クラウド製品で SAML SSO を使用する予定の場合は、移行の前にセットアップを行います。これにより、ユーザーはログイン操作を切り替える必要がなくなります。

SCIM ユーザー プロビジョニング

SCIM ユーザー プロビジョニングのセットアップ プロセスは、何をいつ移行するかによって異なります。

Confluence のみの場合

Confluence のみを移行する (および Jira をまったく使用していない) 場合、Confluence Cloud Migration Assistant でデータやユーザーを移行する前に SCIM をセットアップすることをおすすめします。

Jira のみ / Jira と Confluence 両方の場合

Jira のみを移行する (および Confluence をまったく使用していない) 場合、ユーザーを手動で移行した後、データを移行する前に SCIM をセットアップすることをおすすめします。これは、後述の既知の問題を回避するためです。

Jira と Confluence の両方を移行する予定で、SCIM に接続する必要がある場合、最初に Jira を移行するか、Jira の移行が完了するまでは SCIM を接続しないことをおすすめします。最初に SCIM と Confluence を移行して、後から Jira を移行することを選択した場合、問題が発生する場合があります。以下の手順を実行します。

次の手順が必要になります。

1. ユーザーを手動でインポートする。ユーザーを手動でインポートするには、Atlassian のテクニカル サポート チームに問い合わせて作業を依頼する必要があります。「移行前にユーザーを一括インポートする方法」の手順をご確認ください。

2. SCIM をセットアップする。すべてのユーザーがクラウド製品に正常にインポートされたら、ユーザー プロビジョニングで同期を開始できます。インポート済みの既存のユーザーを外部のアイデンティティ プロバイダーの管理対象とし、外部のアイデンティティ プロバイダーからユーザーを有効化および無効化したり、グループを同期したりすることができます。

3. Resolve group conflicts before syncing. You may run into group conflicts when syncing your external identity provider with your Atlassian organization. When you sync, we’ll warn you about duplicate group names between your external identity provider and your Atlassian organization. You’ll be able to accept or reject changes to group members before you sync those groups. Learn more about resolving group conflicts before syncing.

4. データを移行する。次に、上記のいずれかの方法を使用してデータを移行することを選択できます。

ユーザー移行のトラブルシューティング

移行中に問題が発生した場合、アトラシアンのさまざまなリソースを活用できます。最初に、アトラシアンの公開課題トラッカーで既知の問題を検索することをおすすめします。Jira の移行で発生するいくつかの一般的な問題についての情報 (ステータスや推奨される回避策など) を見つけることができます。

既知の課題は ACCESS-653 - 課題詳細を取得中 ... ステータス です。

詳細情報とサポート

移行をサポートする多数のチャネルをご用意しています。

• For more migration planning information and FAQs, visit the Atlassian Cloud Migration Center.

• 技術的な問題が発生していたり、戦略やベスト プラクティスで支援が必要な場合、お問い合わせください。

• また、アトラシアン コミュニティもご利用ください。

• エキスパートによる支援が必要な場合、アトラシアン パートナーにご相談ください。