ソースリポジトリをリンクする
ソースリポジトリをプロジェクトにリンクする場合、その拡張機能がスペースにインストールされていると、リポジトリをホストするサービスの CodeCatalyst 拡張機能を持つリポジトリを含めることができます。スペース管理者ロールを持つユーザーのみが拡張機能をインストールできます。拡張機能がインストールされたら、その拡張機能によるアクセス用に設定されたリポジトリにリンクできます。詳細については、「スペースに拡張機能をインストールする」または「CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク」を参照してください。
重要
リポジトリ拡張機能をインストールすると、CodeCatalyst にリンクするリポジトリには、インデックスされたコードが作成され CodeCatalyst に保存されます。これにより、CodeCatalyst でコードを検索できるようになります。CodeCatalyst でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については、「Amazon CodeCatalyst ユーザーガイド」の「Data protection」を参照してください。
リポジトリをリンクできるのは、スペース内の 1 つのプロジェクトのみです。アーカイブされたリポジトリをリンクすることはできません。空のリポジトリはリンクできますが、デフォルトブランチを作成する最初のコミットで初期化するまで CodeCatalyst で使用することはできません。また、以下も可能になります。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、スペース内の 1 つの CodeCatalyst プロジェクトにのみリンクできます。
CodeCatalyst プロジェクトでは、空の GitHub リポジトリまたはアーカイブされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用することはできません。
CodeCatalyst プロジェクトのリポジトリと同じ名前の GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをリンクすることはできません。
[GitHub リポジトリ] 拡張機能は GitHub Enterprise Server リポジトリと互換性がありません。
[Bitbucket リポジトリ] 拡張機能は Bitbucket Data Center リポジトリと互換性がありません。
[GitLab リポジトリ] 拡張機能は GitLab self-managed project リポジトリと互換性がありません。
リンクされたリポジトリでは、説明を記述する機能やコメントを要約する機能は使用できません。これらの機能は、CodeCatalyst のプルリクエストでのみ使用できます。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを [コントリビューター] としてリンクすることはできますが、サードパーティーリポジトリのリンクを解除できるのはスペース管理者またはプロジェクト管理者のみです。詳細については、「CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除」を参照してください。
重要
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク」を参照してください。
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。
ソースリポジトリをリンクする
-
リポジトリをリンクするプロジェクトに移動します。
注記
リポジトリをリンクする前に、スペース管理者ロールを持つユーザーは、まずリポジトリをホストするプロバイダーの拡張機能をインストールする必要があります。詳細については、「スペースに拡張機能をインストールする」を参照してください。
ナビゲーションペインで [コード] を選択してから、[ソースリポジトリ] を選択します。
[リポジトリを追加]、[リポジトリをリンク] の順に選択します。
[リポジトリプロバイダー] ドロップダウンメニューで、[GitHub] または [Bitbucket] のいずれかのサードパーティリポジトリプロバイダーを選択します。
-
リンクするサードパーティリポジトリプロバイダーに応じて、次のいずれかを実行します。
-
GitHub リポジトリ: GitHub リポジトリをリンクします。
[GitHub アカウント] ドロップダウンメニューで、リンクするリポジトリを含む GitHub アカウントを選択します。
[GitHub リポジトリ] ドロップダウンメニューで、CodeCatalyst プロジェクトをリンクする GitHub アカウントを選択します。
(オプション) リポジトリの一覧に GitHub リポジトリが表示されない場合は、GitHub の Amazon CodeCatalyst アプリケーションでリポジトリアクセス用にそのリポジトリが設定されていない可能性があります。接続されたアカウントの CodeCatalyst で使用できる GitHub リポジトリを設定できます。
[GitHub]
アカウントに移動し、[設定] > [アプリケーション] の順に選択します。 [インストールされた GitHub アプリ] タブで、Amazon CodeCatalyst アプリケーションの [設定] を選択します。
CodeCatalyst でリンクする GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します。
現在および今後のすべてのリポジトリへのアクセスを許可するには、[すべてのリポジトリ] を選択します。
特定のリポジトリへのアクセスを許可するには、[リポジトリのみを選択] を選択し、[リポジトリを選択] ドロップダウンメニューで、CodeCatalyst でリンクを許可するリポジトリを選択します。
-
Bitbucket リポジトリ: Bitbucket リポジトリをリンクします。
[Bitbucket ワークスペース] ドロップダウンメニューで、リンクするリポジトリを含む Bitbucket ワークスペースを選択します。
[Bitbucket リポジトリ] ドロップダウンメニューで CodeCatalyst プロジェクトをリンクする Bitbucket リポジトリを選択します。
ヒント
リポジトリの名前がグレーアウトされている場合、そのリポジトリは Amazon CodeCatalyst で別のプロジェクトに既にリンクされているため、リンクできません。
-
[Link (リンク)] を選択します。
GitHub リポジトリ、Bitbucket リポジトリまたは CodeCatalyst の GitLab プロジェクトリポジトリを使用する必要がなくなった場合は、CodeCatalyst プロジェクトからそれらのリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除」を参照してください。