Skip to main content

Enterprise Server 3.21 は、現在リリース候補として使用できます。

GitHub Enterprise Importer のマネキンの回収

移行後、プレースホルダー ID (マネキン) の履歴を組織のメンバーに割り当てることができます。

この機能を使用できるユーザーについて

Organization owners can reclaim mannequins.

          GitHub Enterprise ImporterまたはEnterprise Live Migrationsを使用して移行を実行すると、移行されたリポジトリ内のすべてのユーザー アクティビティ (Git コミットを除く) は、マネキンと呼ばれるプレースホルダー ID に属性付けされます。 詳細については、 [AUTOTITLE を](/migrations/overview/mannequins-and-user-activity)参照してください。

マネキンの回収

          GitHub CLI (推奨) またはブラウザーを使用して、マネキンを再利用できます。

メモ

  • リポジトリを別の組織に移譲した後、マネキンを回収することはできません。 移行後にリポジトリを別の組織に移譲したい場合は、移譲前にマネキンを回収する必要があります。
  • マネキンを回収する場合は、既存の組織メンバーのみを対象にすることができます。 マネキンを再利用する前に、招待する GitHub ユーザーが既に組織に追加されていることを確認します。
          GitHub Enterprise Importer は、ユーザー アクセスをリポジトリに移行しません。 マネキンを回収した後、いずれかのユーザーがチーム メンバーシップを介してリポジトリへの適切なアクセス権をまだ持っていない場合、ユーザーにリポジトリへのアクセス権を個別に付与する必要があります。 詳細については、「[Organization のリポジトリへの個人のアクセスを管理する](/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository)」を参照してください。

GitHub CLI を使用してマネキンを回収する (推奨)

          GitHub CLIを使用して、マネキンを個別または一括で回収できます。 
          GitHub CLIの移行拡張機能のインストールと更新の詳細については、[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer) を参照してください。

使用する必要がある正確なコマンドは、使用している GitHub CLI の拡張機能によって異なります。

GEI extensionを使用してマネキンを再取得する

移行ソースが GitHub 製品の場合は、 GEI extension of the GitHub CLIを使用してマネキンを回収できます。

  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、以下の各コマンドに --github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。 personal access token要件については、GitHub 製品間の移行のためのアクセスの管理 を参照してください。
  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。
  1. マネキンを一括回収する必要がある場合は、マネキンを Organization のメンバーにマップする CSV ファイルを作成します。

    • Organization のマネキンのリストを含む CSV ファイルを生成するには、DESTINATION を移行先の組織に置き換え、FILENAME を、生成する CSV ファイルのファイル名に置き換えて、gh gei generate-mannequin-csv コマンドを使用します。

      必要に応じて、既に回収されているマネキンを含めるには、--include-reclaimed フラグを追加します。

      Shell
      gh gei generate-mannequin-csv --github-target-org DESTINATION --output FILENAME.csv
      
    • CSV ファイルを編集して、各マネキンに対応する Organization のメンバーのユーザー名を追加します。

    • ファイルを保存します。

  2. マネキンを回収するには、gh gei reclaim-mannequin コマンドを使用します。

    • 前に作成したマッピング ファイルを使ってマネキンを一括回収するには、DESTINATION を移行先の Organization に置き換え、FILENAME をマッピング ファイルのファイル名に置き換えます。

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --csv FILENAME.csv
      
    • 個々のマネキンを回収するには、DESTINATION を移行先組織、MANNEQUIN をマネキンのログイン、USERNAME をマネキンに対応する Organization メンバーのユーザー名に、それぞれ置き換えます。

      同じログインを持つ複数のマネキンがある場合は、--mannequin-user MANNEQUIN--mannequin-ID ID に置き換え、ID をマネキンの ID に置き換えることができます。

      組織で Enterprise Managed Users を使用していて、マネキンをすぐに再要求するために属性の招待をスキップする場合は、--skip-invitation 引数を追加します。

      Shell
      gh gei reclaim-mannequin --github-target-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
      

デフォルトでは、組織のメンバーはメールで招待を受け取り、メンバーが招待を受け入れるまでマネキンは再要求されません。

ADO2GH extensionを使用してマネキンを取り戻す

移行ソースがAzure DevOpsされている場合は、ADO2GH extension of the GitHub CLIを使用してマネキンを再利用できます。

  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、以下の各コマンドに --github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。

  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。

  1. マネキンを一括回収する必要がある場合は、マネキンを Organization のメンバーにマップする CSV ファイルを作成します。

    • Organization のマネキンのリストを含む CSV ファイルを生成するには、DESTINATION を移行先の組織に置き換え、FILENAME を、生成する CSV ファイルのファイル名に置き換えて、gh ado2gh generate-mannequin-csv コマンドを使用します。

      必要に応じて、既に回収されているマネキンを含めるには、--include-reclaimed フラグを追加します。

      Shell
      gh ado2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv
      
    • CSV ファイルを編集して、各マネキンに対応する Organization のメンバーのユーザー名を追加します。

    • ファイルを保存します。

  2. マネキンを回収するには、gh ado2gh reclaim-mannequin コマンドを使用します。

    • 前に作成したマッピング ファイルを使ってマネキンを一括回収するには、DESTINATION を移行先の Organization に置き換え、FILENAME をマッピング ファイルのファイル名に置き換えます。

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv
      
    • 個々のマネキンを回収するには、DESTINATION を移行先組織、MANNEQUIN をマネキンのログイン、USERNAME をマネキンに対応する Organization メンバーのユーザー名に、それぞれ置き換えます。

      同じログインを持つ複数のマネキンがある場合は、--mannequin-user MANNEQUIN--mannequin-ID ID に置き換え、ID をマネキンの ID に置き換えることができます。

      組織で Enterprise Managed Users を使用していて、マネキンをすぐに再要求するために属性の招待をスキップする場合は、--skip-invitation 引数を追加します。

      Shell
      gh ado2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
      

デフォルトでは、組織のメンバーはメールで招待を受け取り、メンバーが招待を受け入れるまでマネキンは再要求されません。

BBS2GH extension

を使用してマネキンを回収します

移行ソースが Bitbucket Serverは、 BBS2GH extension of the GitHub CLIを使用してマネキンを再利用できます。

  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、以下の各コマンドに --github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。 personal access token要件については、Bitbucket サーバーからの移行のアクセスの管理 を参照してください。
  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。
  1. マネキンを一括回収する必要がある場合は、マネキンを Organization のメンバーにマップする CSV ファイルを作成します。

    • Organization のマネキンのリストを含む CSV ファイルを生成するには、DESTINATION を移行先の組織に置き換え、FILENAME を、生成する CSV ファイルのファイル名に置き換えて、gh bbs2gh generate-mannequin-csv コマンドを使用します。

      必要に応じて、既に回収されているマネキンを含めるには、--include-reclaimed フラグを追加します。

      Shell
      gh bbs2gh generate-mannequin-csv --github-org DESTINATION --output FILENAME.csv
      
    • CSV ファイルを編集して、各マネキンに対応する Organization のメンバーのユーザー名を追加します。

    • ファイルを保存します。

  2. マネキンを回収するには、gh bbs2gh reclaim-mannequin コマンドを使用します。

    • 前に作成したマッピング ファイルを使ってマネキンを一括回収するには、DESTINATION を移行先の Organization に置き換え、FILENAME をマッピング ファイルのファイル名に置き換えます。

      Shell
      gh bbs2gh reclaim-mannequin --github-org DESTINATION --csv FILENAME.csv
      
    • 個々のマネキンを回収するには、DESTINATION を移行先組織、MANNEQUIN をマネキンのログイン、USERNAME をマネキンに対応する Organization メンバーのユーザー名に、それぞれ置き換えます。

      同じログインを持つ複数のマネキンがある場合は、--mannequin-user MANNEQUIN--mannequin-ID ID に置き換え、ID をマネキンの ID に置き換えることができます。

      組織で Enterprise Managed Users を使用していて、マネキンをすぐに再要求するために属性の招待をスキップする場合は、--skip-invitation 引数を追加します。

      Shell
      gh bbs2gh reclaim-mannequin --github-org DESTINATION --mannequin-user MANNEQUIN --target-user USERNAME
      

デフォルトでは、組織のメンバーはメールで招待を受け取り、メンバーが招待を受け入れるまでマネキンは再要求されません。

ブラウザーでマネキンを回収する

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

  3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  4. サイドバーの [Access] セクションで、[ Import/Export] をクリックします。

  5. 回収するマネキンの右側にある [再帰属] をクリックします。

  6. 検索フィールドに、マネキンのコントリビューションを帰属させる Organization メンバーのユーザー名を入力し、そのメンバーをクリックします。

    メモ

    組織のメンバーであるユーザーアカウントにのみ帰属招待を送信することができます。

  7. [ 招待] をクリックします。 デフォルトでは、組織のメンバーはメールで招待を受け取り、メンバーが招待を受け入れるまでマネキンは再要求されません。

帰属の招待の状態を表示する

組織内のすべてのアトリビューションの招待について、その状態を表示できます。

  • 招待済み: ユーザーは招待を受け取りましたが、まだ返信していません。
  • 完了: ユーザーが承諾したか、招待プロセスがスキップされました。 ユーザーの投稿が再割り当てされました。
  • 拒否: ユーザーは、マネキンのコントリビューションに対してクレジットを与えないことを選択しました。
  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

  3. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  4. サイドバーの [Access] セクションで、[ Import/Export] をクリックします。

  5. [ インポート/エクスポート] で、[アトリビューション招待] をクリックします。

    リポジトリの [インポート/エクスポート] ページのスクリーンショット。 [帰属の招待] というラベルの付いたタブが濃いオレンジ色で囲まれています。

Git コミットの作成者を管理する

Gitコミットの作者はマネキンに関連付けられていないため、マネキンを使ってユーザーGitHubに帰属させることはできません。 代わりに、コミットの作成は、Git でのコミットの作成に使用された電子メール アドレスに基づいて、 GitHub のユーザー アカウントに起因します。

多くの場合、ユーザーは、コミットの作成に使用する電子メール アドレスを GitHubのユーザー アカウントに追加することで、コミットを自分自身に再度適用できます。 詳しくは、「GitHub アカウントへのメール アドレスの追加」をご覧ください。

ただし、 Enterprise Managed Usersを使用する場合、ユーザーは GitHub でユーザー アカウントに電子メール アドレスを追加できないため、Git コミットを再属性化することはできません。 ID プロバイダー (IdP) のユーザーのプライマリ 電子メール アドレスによって作成されたコミットのみが、 マネージド ユーザー アカウントに属性付けされます。

さらに、 GitHub指定された noreply メール アドレスによって作成されたコミットは、ユーザー アカウントに noreply の電子メール アドレスを手動で追加できないため、再属性付けできません。 詳しくは、「コミットメールアドレスを設定する」をご覧ください。