GitHub からのデータのインポート
The Jira Importers plugin, which is bundled with Jira, allows you to import data from GitHub by connecting to a live GitHub database.
GitHub インポーターは Jira 6.1 以降との互換性を持ちます。
Our main website highlights some top reasons why people migrate from GitHub to Jira.
GitHub インポート プロセスでは GitHub Import Wizard を実行します。このウィザードでは GitHub に接続し、データを Jira にマッピングおよびインポートします。GitHub インポーターは、ご利用の GitHub のユーザー名とパスワード (ユーザーが指定) または Personal Access Token を使用して GitHub に接続します。GitHub Enterprise を使用している場合、GitHub Enterprise URL (GitHub の Enterprise Settings で確認可能) も入力する必要があります。GitHub インポーターは、アカウントのパーソナルおよびパブリックリポジトリ、その他のお気に入りリポジトリにアクセスしてデータをインポートします。データのインポート元として使用するリポジトリをお気に入りに登録しておくことをおすすめします。パーソナル、パブリック、お気に入りリポジトリをすべて選択する必要はありません。GitHub インポーターはアクセス可能なすべてのリポジトリを表示するため、そこからインポートするものを選択できます。GitHub インスタンスで 2 段階認証を使用している場合、送信される 6 桁のアクセス コードかバックアップ コードが求められます。
If you have attachments in GitHub and you want to import these too, you must ensure you have attachments enabled in Jira. Attachments are enabled by default.
GitHub Import Wizard の実行
Jira インストールに既存のデータがある場合、開始する前に、既存の Jira データをバックアップします。
- Jira 管理者グローバル権限を持つユーザーとしてログインします。
> [システム] を選択します。[インポートとエクスポート] > [外部システム インポート] を選択し、[外部プロジェクトのインポート] ページを開きます。 - GitHub を選択してGitHub インポートウィザードを開きます。
On the GitHub Setup page, select which type of GitHub you are using. If you are using GitHub Enterprise you will also be required to provide your GitHub Enterprise URL. You also need to provide either your GitHub username and password, or a GitHub Personal Access Token. Note if you have used the GitHub import wizard before and saved a previous configuration file, you can select the configuration file here to speed up your import.
[次へ] をクリックします。
認証ページが表示され、認証に成功したことが通知されます。
- 次へをクリックします。Map projects ページに、パブリックおよびプライベートリポジトリ、その他の登録済みリポジトリが表示されます。
- On the Map projects page, select the repositories you want to import data from, and where you want to import it to. All GitHub projects are initially set to "Don't import this project". To import a repository, you must either select an existing compatible project to import the data to, or create a new project.
To create a new project, select Create New from the drop-down menu and in the resulting Add A New Project dialog box, type the following:- 新規プロジェクトの名前
- A new project Key This will be used as the prefix for all issue IDs in your Jira project.
- プロジェクトリード
- 次へをクリックします。Fetching Data ページが表示され、インポートの進行状況が更新されます。
- インポートが完了すると、[ラベル] ページが表示されます。GitHub はラベルのみを使用しますが、ラベルを課題タイプや解決状況にマッピングできるようになりました。すべてのラベルをマッピングする必要はありません。GitHub のマッピングされていないラベルに対応する Jira のラベルを作成する場合は、"Add Jira labels..." チェックボックスが選択されていることを確認します。
- [次へ] をクリックします。[ワークフロー ステータスのマッピング] ページが表示され、インポートした GitHub リポジトリに適用するワークフローを選択できます。また、GitHub のオープンまたはクローズ済み課題のマッピング先も選択する必要があります。既定では、オープンがオープンに、クローズ済みがクローズ済みにマッピングされますが、Jira ワークフローで使用可能な課題ステータスを選択できます。
インポート開始をクリックします。
- Success! You have completed importing your GitHub data to Jira. If there were any errors or warnings, these will be displayed to make you aware that you may need to check some details. Note:
- インポートで問題が生じた場合 (または関心がある場合)、詳細ログのダウンロードリンクをクリックして、GitHub Import Wizard プロセスに関する詳細情報を表示します。
- この手順を通じて使用した設定と同じ (または類似の) 設定で、別のGitHub リポジトリをインポートする必要がある場合は、設定を保存リンクをクリックして、GitHub 設定ファイルをダウンロードします。この設定ファイルは、GitHub Import Wizard の最初の手順で使用できます。
これで、GitHub のリポジトリ データを Jira に正常にインポートできました。ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。