Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する
Amazon CodeCatalyst には、機能を追加し、CodeCatalyst 以外の製品と統合するのに役立つ拡張機能が含まれています。CodeCatalyst カタログの拡張機能を使用すると、チームは CodeCatalyst でのエクスペリエンスをカスタマイズできます。
**Topics**
+ [利用可能なサードパーティー拡張機能](#extensions-types)
+ [拡張機能のコンセプト](extensions-concepts.md)
+ [クイックスタート: CodeCatalyst での拡張機能のインストール、プロバイダーの接続、リソースのリンク](extensions-quickstart.md)
+ [スペースに拡張機能をインストールする](install-extension.md)
+ [スペースの拡張機能をアンインストールする](uninstall-extension.md)
+ [GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、および Jira サイト CodeCatalyst に接続](extensions-connect.md)
+ [GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、Jira サイトの CodeCatalyst の切断](extensions-disconnect.md)
+ [CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)
+ [CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)
+ [CodeCatalyst でのサードパーティーリポジトリの表示と Jira の問題の検索](extensions-view-search.md)
+ [サードパーティーリポジトリイベント後にワークフローを自動的に開始](extensions-workflow-repositories.md)
+ [サードパーティーリポジトリプロバイダーによる IP アクセスの制限](extensions-restrict-ip-access.md)
+ [ワークフローが失敗した場合のサードパーティーマージのブロック](extensions-block-merges.md)
+ [Jira の問題を CodeCatalyst プルリクエストにリンクする](link-jira-issues-pull-requests.md)
+ [Jira 問題における CodeCatalyst イベントの表示](view-codecatalyst-events-jira.md)
## 利用可能なサードパーティー拡張機能
CodeCatalyst プロジェクトには、リソースの統合を選択した拡張機能に応じて、特定の機能を追加できます。
### CodeCatalyst での GitHub リポジトリの統合
GitHub は、デベロッパーがコードを保存および管理するためのクラウドベースのサービスです。**[GitHub リポジトリ]** 拡張機能を使用すると、Amazon CodeCatalyst プロジェクト内からリンクされた GitHub リポジトリを使用できます。新しい CodeCatalyst プロジェクトを作成するときに GitHub リポジトリをリンクすることもできます。詳細については、「[リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](projects-create.md#projects-create-3p-repo)」を参照してください。
**注記**
CodeCatalyst プロジェクトでは、空の GitHub リポジトリまたはアーカイブされた GitHub リポジトリを使用することはできません。
**[GitHub リポジトリ]** 拡張機能は、GitHub Enterprise Server リポジトリと互換性がありません。
**[GitHub リポジトリ]** 拡張機能をインストールして設定すると、次のことができるようになります。
+ CodeCatalyst のソースリポジトリの一覧に GitHub リポジトリを表示する
+ GitHub リポジトリにワークフロー定義ファイルを保存および管理する
+ CodeCatalyst 開発環境からリンクされた GitHub リポジトリに保存されているファイルの作成、読み取り、更新、削除
+ CodeCatalyst にリンクされた GitHub リポジトリからファイルを保存してインデックスを作成する
+ 接続された GitHub アカウントの既存のリポジトリを使用して CodeCatalyst プロジェクトを作成する
+ ブループリントを使用してプロジェクトを作成するとき、またはブループリントを追加するときに、ブループリントによって生成されたコードを使用して GitHub リポジトリを作成する
+ Start CodeCatalyst ワークフローは、コードがリンクされた GitHub リポジトリにプッシュされたとき、またはリンクされた GitHub リポジトリでプルリクエストが作成、変更、または閉じられたときに自動的に実行されます。
+ CodeCatalyst ワークフローでリンクされた GitHub リポジトリソースファイルを使用する
+ CodeCatalyst ワークフローで GitHub アクションを読み取って実行する
+ リンクされた GitHub リポジトリに CodeCatalyst ワークフロー実行ステータスを送信し、コミットステータスに基づいて GitHub プルリクエストマージをブロックする
### CodeCatalyst での Bitbucket リポジトリの統合
Bitbucket は、デベロッパーがコードを保存および管理するためのクラウドベースのサービスです。**[Bitbucket リポジトリ]** 拡張機能を使用すると、Amazon CodeCatalyst プロジェクト内からリンクされた Bitbucket リポジトリを使用できます。新しい CodeCatalyst プロジェクトを作成するときに Bitbucket リポジトリをリンクすることもできます。詳細については、「[リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](projects-create.md#projects-create-3p-repo)」を参照してください。
**注記**
CodeCatalyst プロジェクトでは、空の Bitbucket リポジトリまたはアーカイブされた Bitbucket リポジトリを使用することはできません。
**[Bitbucket リポジトリ]** 拡張機能は Bitbucket データセンターリポジトリと互換性がありません。
**[Bitbucket リポジトリ]** 拡張機能をインストールして設定すると、次のことができるようになります。
+ CodeCatalyst のソースリポジトリの一覧に Bitbucket リポジトリを表示する
+ Bitbucket リポジトリにワークフロー定義ファイルを保存および管理します。
+ CodeCatalyst 開発環境からリンクされた Bitbucket リポジトリに保存されているファイルの作成、読み取り、更新、削除
+ 接続された Bitbucket アカウントの既存のリポジトリを使用して CodeCatalyst プロジェクトを作成する
+ CodeCatalyst にリンクされた Bitbucket リポジトリからファイルを保存してインデックスを作成する
+ ブループリントを使用してプロジェクトを作成するとき、またはブループリントを追加するときに、ブループリントによって生成されたコードを使用して Bitbucket リポジトリを作成する
+ Start CodeCatalyst ワークフローは、コードがリンクされた Bitbucket リポジトリにプッシュされたとき、またはリンクされた Bitbucket リポジトリでプルリクエストが作成、変更、または閉じられたときに自動的に実行されます。
+ CodeCatalyst ワークフローでリンクされた Bitbucket リポジトリソースファイルを使用する
+ リンクされた Bitbucket リポジトリに CodeCatalyst ワークフロー実行ステータスを送信し、コミットステータスに基づいて Bitbucket プルリクエストマージをブロックする
### CodeCatalyst での GitLab リポジトリの統合
GitLab は、デベロッパーがコードを保存および管理するためのクラウドベースのサービスです。**GitLab リポジトリ**拡張機能を使用すると、Amazon CodeCatalyst プロジェクト内からリンクされた GitLab リポジトリを使用できます。新しい CodeCatalyst プロジェクトを作成するときに GitLab プロジェクトをリンクすることもできます。詳細については、「[リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](projects-create.md#projects-create-3p-repo)」を参照してください。
**注記**
CodeCatalyst プロジェクトでは、空の GitLab リポジトリまたはアーカイブされた GitLab リポジトリを使用することはできません。
**GitLab リポジトリ**拡張機能は、GitLab セルフマネージドリポジトリと互換性がありません。
**GitLab リポジトリ**拡張機能をインストールして設定すると、次のことができるようになります。
+ CodeCatalyst のソースリポジトリの一覧で GitLab プロジェクトリポジトリを表示する
+ ワークフロー定義ファイルを GitLab プロジェクトリポジトリに保存および管理する
+ CodeCatalyst 開発環境からリンクされた GitLab プロジェクトリポジトリに保存されているファイルの作成、読み取り、更新、削除を行う
+ 接続された GitLab ユーザーの既存のリポジトリを使用して CodeCatalyst プロジェクトを作成する
+ CodeCatalyst にリンクされた GitLab プロジェクトリポジトリからファイルを保存してインデックスを作成する
+ ブループリントを使用してプロジェクトを作成するとき、またはブループリントを追加するときに、ブループリントによって生成されたコードを使用して GitLab プロジェクトリポジトリを作成する
+ コードがリンクされた GitLab プロジェクトのリポジトリにプッシュされた場合、またはリンクされた GitLab プロジェクトのリポジトリでプルリクエストが作成、修正、またはクローズされた場合に、CodeCatalyst ワークフローの実行を自動的に開始する
+ CodeCatalyst ワークフローでリンクされた GitLab プロジェクトリポジトリソースファイルを使用する
+ リンクされた GitLab プロジェクトリポジトリに CodeCatalyst ワークフロー実行ステータスを送信し、コミットステータスに基づいて GitLab マージリクエストをブロックする
### CodeCatalyst での Jira の問題の統合
Jira は、アジャイル開発チームが作業を計画、割り当て、追跡、報告、管理するのに役立つソフトウェアアプリケーションです。**Jira Software** 拡張機能を使用すると、Amazon CodeCatalyst プロジェクトで Jira プロジェクトを使用できます。
**注記**
CodeCatalyst は、**Jira Software Cloud** とのみ互換性があります。
Amazon CodeCatalyst プロジェクトの **Jira Software** 拡張機能をインストールして設定すると、次のことができるようになります。
+ CodeCatalyst プロジェクトにリンクして CodeCatalyst から Jira プロジェクトにアクセスする
+ CodeCatalyst プルリクエストに関する Jira の問題を更新する
+ Jira の問題でリンクされた CodeCatalyst プルリクエストのステータスとワークフローの実行を表示する
# 拡張機能のコンセプト
CodeCatalyst で拡張機能を使用する際に知っておくべきコンセプトと用語をいくつか紹介します。
## 拡張子
*[拡張機能]* は、CodeCatalyst スペースにインストールしてプロジェクトに新しい機能を追加し、CodeCatalyst 以外のサービスと統合できるアドオンです。拡張機能は、CodeCatalyst カタログから参照およびインストールできます。
## CodeCatalyst カタログ
CodeCatalyst カタログは、CodeCatalyst で利用可能なすべての拡張機能を一元的に一覧表示したものです。CodeCatalyst カタログを参照して、ソース、ワークフローなどの CodeCatalyst の分野でのチームのエクスペリエンスを向上させる拡張機能を見つけることができます。
## 接続とリンク
使用または管理するサードパーティーリソースに応じて、GitHub アカウント、Bitbucket ワークスペース、または Jira プロジェクトを接続する必要があります。次に、GitHub リポジトリ、Bitbucket リポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクする必要があります。
+ **GitHub リポジトリ**: GitHub アカウントを接続し、GitHub リポジトリをリンクします。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースを接続し、Bitbucket リポジトリをリンクします。
+ **GitLab リポジトリ**: GitLab ユーザーを接続し、GitLab プロジェクトリポジトリをリンクします。
+ **Jira Software**: Jira サイトを接続し、Jira プロジェクトをリンクします。
# クイックスタート: CodeCatalyst での拡張機能のインストール、プロバイダーの接続、リソースのリンク
このチュートリアルでは、次の 3 つのタスクについて説明します。
1. **GitHub リポジトリ**、**Bitbucket リポジトリ**、**GitLab リポジトリ **、または **Jira Software** 拡張機能をインストールします。外部サイトでは、サードパーティリソースに接続して CodeCatalyst にアクセス権を付与するように求められます。これは次のステップの一環として行われます。
**重要**
**GitHub リポジトリ**、**Bitbucket リポジトリ**、**GitLab リポジトリ**、または **Jira ソフトウェア**拡張機能を CodeCatalyst スペースにインストールするには、スペース**管理者**ロールを持つアカウントでサインインする必要があります。
1. GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、または Jira サイトを CodeCatalyst に接続します。
**重要**
GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、または Jira サイトを CodeCatalyst スペースに接続するには、サードパーティーソースの管理者と CodeCatalyst **[スペース管理者]**の両方である必要があります。
**重要**
リポジトリ拡張機能をインストールすると、CodeCatalyst にリンクするリポジトリには、コードのインデックスが作成され CodeCatalyst に保存されます。これにより、コードが CodeCatalyst で検索できるようになります。CodeCatalyst でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については、*「Amazon CodeCatalyst ユーザーガイド*」の「[データ保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)」を参照してください。
**注記**
GitHub アカウントへの接続を使用している場合は、CodeCatalyst ID と GitHub ID 間の ID マッピングを確立するための個人用接続を作成する必要があります。詳細については、「[個人用接続](concepts.md#personal-connection-concept)」および「[個人接続を使用して GitHub リソースにアクセスする](ipa-settings-connections.md)」を参照してください。
1. GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクします。
**重要**
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを **[コントリビューター]** としてリンクすることはできますが、サードパーティーリポジトリのリンクを解除できるのは **[スペース管理者]** または **[プロジェクト管理者]** のみです。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
Jira プロジェクトを CodeCatalyst プロジェクトにリンクするには、CodeCatalyst **スペース管理者**または CodeCatalyst **プロジェクト管理者**である必要があります。
**重要**
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。
**注記**
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、スペース内の 1 つの CodeCatalyst プロジェクトにのみリンクできます。
CodeCatalyst プロジェクトでは、空の GitHub リポジトリまたはアーカイブされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用することはできません。
CodeCatalyst プロジェクトのリポジトリと同じ名前の GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをリンクすることはできません。
**[GitHub リポジトリ]** 拡張機能は GitHub Enterprise Server リポジトリと互換性がありません。
**[Bitbucket リポジトリ]** 拡張機能は Bitbucket データセンターリポジトリと互換性がありません。
**[GitLab リポジトリ]** 拡張機能は GitLab セルフマネージドプロジェクトリポジトリと互換性がありません。
リンクされたリポジトリでは、**説明を記述する**機能や**コメントを要約する**機能は使用できません。これらの機能は、CodeCatalyst のプルリクエストでのみ使用できます。
CodeCatalyst プロジェクトは、1 つの Jira プロジェクトにのみリンクできます。Jira プロジェクトは、複数の CodeCatalyst プロジェクトにリンクできます。
また、**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]** 拡張機能をインストールし、GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーに接続し、新しい CodeCatalyst プロジェクトを作成するときにサードパーティーリポジトリをリンクすることもできます。詳細については、「[リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](projects-create.md#projects-create-3p-repo)」を参照してください。
**Topics**
+ [ステップ 1: CodeCatalyst カタログからサードパーティー拡張機能をインストールする](#extensions-quickstart-install)
+ [ステップ 2: サードパーティープロバイダーを CodeCatalyst スペースに接続する](#extensions-github-extension-get-started-connect)
+ [ステップ 3: サードパーティーリソースを CodeCatalyst プロジェクトにリンクする](#extensions-quickstart-link)
+ [次の手順](#extensions-quickstart-next-steps)
## ステップ 1: CodeCatalyst カタログからサードパーティー拡張機能をインストールする
CodeCatalyst で thid-party リソースを使用する最初のステップは、CodeCatalyst カタログから **[GitHub リポジトリ]** 拡張機能をインストールすることです。拡張機能をインストールするには、使用するサードパーティーリソースの拡張機能を選択して、次の手順を実行します。**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]** では、CodeCatalyst で GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用できます。**[Jira Software]** では、CodeCatalyst で Jira の問題を管理できます。
**CodeCatalyst カタログから拡張機能をインストールするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 検索バーの横にある上部のメニューバーの **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択して、CodeCatalyst カタログに移動します。「**GitHub リポジトリ**」、「**Bitbucket リポジトリ**」、「**GitLab リポジトリ**」、または「**Jira Software**」で検索できます。カテゴリに基づいて拡張をフィルタリングすることもできます。
1. (オプション) 拡張機能が持つアクセス許可など、拡張機能の詳細を確認するには、リポジトリ拡張名を選択します。
1. **[インストール]** を選択します。拡張機能に必要なアクセス許可を確認し、続行する場合は、**[インストール]** を再度選択します。
拡張機能をインストールすると、拡張機能の詳細ページに移動します。インストールした拡張機能に応じて、接続されたプロバイダーとリンクされたリソースを表示および管理できます。
## ステップ 2: サードパーティープロバイダーを CodeCatalyst スペースに接続する
**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]**、または **[Jira Software]** 拡張機能をインストールした後、次のステップは GitHub アカウント、Bitbucket ワークスペース、GitLab プロジェクトリポジトリ、または Jira サイトを CodeCatalyst スペースに接続することです。
**GitHub アカウント、Bitbucket ワークスペース、または Jira サイトを CodeCatalyst に接続するには**
+ インストールしたサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub アカウントに接続します。
1. **[接続済み GitHub アカウント]** タブで、**[GitHub アカウントを接続]** を選択して、GitHub の外部サイトに移動します。
1. GitHub 認証情報を使用して GitHub アカウントにサインインし、Amazon CodeCatalyst をインストールするアカウントを選択します。
**ヒント**
以前に GitHub アカウントをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の GitHub 組織のメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログボックスが表示されます。1 つの GitHub 組織のみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。リポジトリへのアクセスを許可するアプリケーションを設定し、**[保存]** を選択します。**[保存]** ボタンがアクティブでない場合は、設定を変更してから再試行してください。
1. CodeCatalyst で現在と今後のすべてのリポジトリにアクセスできるようにすることを選択するか、または CodeCatalyst で使用する特定の GitHub リポジトリを選択します。デフォルトのオプションでは、CodeCatalyst によってアクセスされる今後のリポジトリなど、GitHub アカウントにすべての GitHub リポジトリが含まれます。
1. CodeCatalyst に付与されているアクセス許可を確認してから、**[インストール]** を選択します。
GitHub アカウントを CodeCatalyst に接続すると、**[GitHub リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された GitHub アカウントとリンクされた GitHub リポジトリを表示および管理できます。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースに接続します。
1. **[Connected Bitbucket ワークスペース]** タブで、**[Connect Bitbucket ワークスペース]** を選択して Bitbucket の外部サイトに移動します。
1. Bitbucket 認証情報を使用して Bitbucket ワークスペースにサインインし、CodeCatalyst に付与されたアクセス許可を確認します。
1. **[ワークスペースの認証]** ドロップダウンメニューから、CodeCatalyst へのアクセスを許可する Bitbucket ワークスペースを選択し、**[アクセスを許可] ** を選択します。
**ヒント**
以前に Bitbucket ワークスペースをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の Bitbucket ワークスペースのメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログが表示されます。1 つの Bitbucket ワークスペースのみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。ワークスペースのアクセスを許可するアプリケーションを設定し、**[アクセスを許可]** を選択します。**[アクセスを許可]** ボタンがアクティブでない場合は、設定を変更してから、再試行してください。
Bitbucket ワークスペースを CodeCatalyst に接続すると、**[Bitbucket リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された Bitbucket ワークスペースとリンクされた Bitbucket リポジトリを表示および管理できます。
+ **GitLab リポジトリ**: GitLab ユーザーに接続します。
1. **[GitLab ユーザーを接続]** を選択して、GitLab の外部サイトに移動します。
1. GitLab 認証情報を使用して GitLab ユーザーにログインし、CodeCatalyst に付与されたアクセス許可を確認します。
**ヒント**
以前に GitLab ユーザーをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、CodeCatalyst コンソールに戻ります。
1. **GitLab の AWS コネクタの承認**を選択します。
GitLab ユーザーを CodeCatalyst に接続すると、**GitLab リポジトリ**拡張機能の詳細ページに移動します。このページでは、接続された GitLab ユーザーと、リンクされた GitLab プロジェクトリポジトリを表示および管理できます。
+ **[Jira Software]**: Jira サイトを接続します。
1. **[Connected Jira サイト]** タブで、**[Connect Jira サイト]** を選択して、Atlassian Marketplace の外部サイトに移動します。
1. **[今すぐ取得]** を選択して、Jira サイトへの CodeCatalyst のインストールを開始します。
**注記**
以前に CodeCatalyst を Jira サイトにインストールした場合は、通知が届きます。**[使用を開始]** を選択し、最終ステップに進みます。
1. ロールに応じて、次のいずれかを実行します。
1. Jira サイト管理者の場合は、サイトのドロップダウンメニューから、Jira サイトを選択して CodeCatalyst アプリケーションをインストールし、**[アプリをインストール]** を選択します。
**注記**
Jira サイトが 1 つある場合、このステップは表示されず、自動的に次のステップに移動します。
1.
1. Jira 管理者でない場合は、サイトのドロップダウンメニューから、Jira サイトを選択して CodeCatalyst アプリケーションをインストールし、**[アプリをリクエスト]** を選択します。Jira アプリケーションのインストールの詳細については、「[アプリケーションをインストールできるユーザー](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)」を参照してください。
1. CodeCatalyst を入力テキストフィールドに入力するか、デフォルトのテキストを保持する必要がある理由を入力し、**[リクエストを送信]** を選択します。
1. アプリケーションのインストール時に CodeCatalyst によって実行されたアクションを確認し、**[今すぐ取得]** を選択します。
1. アプリケーションをインストールしたら、**[CodeCatalyst に戻る]** を選択して CodeCatalyst に戻ります。
Jira サイトを CodeCatalyst に接続したら、**[Jira Software]** 拡張機能の詳細ページの **[Connected Jira サイト]** タブで接続されたサイトを表示できます。
## ステップ 3: サードパーティーリソースを CodeCatalyst プロジェクトにリンクする
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用するか、CodeCatalyst で Jira の問題を管理するための 3 番目の最後のステップは、それらを使用する CodeCatalyst プロジェクトにリンクすることです。
**拡張機能の詳細ページから、GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクします。**
+ インストールしたサードパーティー拡張機能と、接続されたプロバイダーに応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub リポジトリをリンクします。
1. **[リンクされた GitHub リポジトリ]** タブで、**[GitHub リポジトリをリンク]** を選択します。
1. **[GitHub アカウント]** ドロップダウンメニューから、リンクするリポジトリを含む GitHub アカウントを選択します。
1. **[GitHub リポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. (オプション) リポジトリの一覧に GitHub リポジトリが表示されない場合は、GitHub の Amazon CodeCatalyst アプリケーションでリポジトリアクセス用に設定されていない可能性があります。接続されたアカウントの CodeCatalyst で使用できる GitHub リポジトリを設定できます。
1. [[GitHub]](https://github.com/) アカウントに移動し、**[設定]** > **[アプリケーション]** の順に選択します。
1. **[インストールされた GitHub アプリ]** タブで、Amazon CodeCatalyst アプリケーションの **[設定]** を選択します。
1. CodeCatalyst でリンクする GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します。
+ 現在および今後のすべてのリポジトリへのアクセスを許可するには、**[すべてのリポジトリ]** を選択します。
+ 特定のリポジトリへのアクセスを許可するには、**[リポジトリのみを選択]** を選択し、**[リポジトリを選択]** ドロップダウンメニューで、CodeCatalyst でリンクを許可するリポジトリを選択します。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、GitHub リポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で GitHub リポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **Bitbucket リポジトリ**: Bitbucket リポジトリをリンクします。
1. **[リンクされた Bitbucket リポジトリ]** タブで、**[Bitbucket リポジトリをリンク]** を選択します。
1. **[Bitbucket ワークスペース]** ドロップダウンメニューから、リンクするリポジトリを含む Bitbucket ワークスペースを選択します。
1. **[Bitbucket リポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、Bitbucket リポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で Bitbucket リポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **[GitLab リポジトリ]**: GitLab プロジェクトリポジトリをリンクします。
1. **[Linked GitLab プロジェクトリポジトリ]** タブで、**[Link GitLab プロジェクトリポジトリ]** を選択します。
1. **[GitLab ユーザー]** ドロップダウンメニューから、リンクするリポジトリを含む GitLab ユーザーを選択します。
1. **[GitHub プロジェクトリポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、GitLab プロジェクトリポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で GitLab プロジェクトリポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。プロジェクトリポジトリのリンクが解除されると、そのプロジェクトリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのプロジェクトリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **Jira Software**: Jira プロジェクトをリンクします。
1. **[リンクされた Jira プロジェクト]** タブで、**[Jira プロジェクトをリンク]** を選択します。
1. **[Jira サイト]** ドロップダウンメニューから、リンクするプロジェクトを含む Jira サイトを選択します。
1. **[Jira プロジェクト]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするプロジェクトを選択します。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、Jira プロジェクトをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
Jira プロジェクトが CodeCatalyst プロジェクトにリンクされると、CodeCatalyst の問題へのアクセスは完全に無効になり、CodeCatalyst ナビゲーションペインの **[問題]** は、Jira プロジェクトにリンクする **[Jira の問題]** 項目に置き換えられます。
![\[CodeCatalyst の問題は、ナビゲーションペインでリンクされた Jira の問題に置き換えられました。\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
CodeCatalyst で Jira プロジェクトを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。Jira プロジェクトがリンク解除されると、Jira の問題は CodeCatalyst プロジェクトで利用できなくなり、CodeCatalyst の **[問題]** が再び問題プロバイダーになります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを、**[コード]** の **[ソースリポジトリ]** からプロジェクトにリンクすることもできます。詳細については、「[接続されたサードパーティープロバイダーからのリソースのリンク](extensions-link.md#extensions-link-resources)」を参照してください。
## 次の手順
**[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、または **[GitLab リポジトリ]** 拡張機能をインストールし、リソースプロバイダーを接続し、サードパーティーリポジトリを CodeCatalyst プロジェクトにリンクしたら、CodeCatalyst ワークフローと開発環境で使用できます。ブループリントから生成されたコードを使用して、接続された GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーでサードパーティーリポジトリを作成することもできます。詳細については、「[サードパーティーリポジトリイベント後にワークフローを自動的に開始](extensions-workflow-repositories.md)」および「[開発環境の作成](devenvironment-create.md)」を参照してください。
**[Jira Software]** 拡張機能をインストールし、Jira サイトを接続し、Jira プロジェクトを CodeCatalyst プロジェクトにリンクし、プルリクエストをリンクすると、CodeCatalyst の更新が Jira プロジェクトに反映されます。プルリクエストを Jira の問題にリンクする詳細については、「[Jira の問題を CodeCatalyst プルリクエストにリンクする](link-jira-issues-pull-requests.md)」を参照してください。Jira での CodeCatalyst イベントの表示の詳細については、「[Jira 問題における CodeCatalyst イベントの表示](view-codecatalyst-events-jira.md)」を参照してください。
# スペースに拡張機能をインストールする
CodeCatalyst スペースに拡張機能をインストールして、そのスペースのプロジェクトに機能を追加できます。CodeCatalyst カタログを表示するには、**[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) をクリックします。拡張機能とその機能の詳細については、「[利用可能なサードパーティー拡張機能](extensions.md#extensions-types)」を参照してください。
**重要**
拡張機能をインストールするには、スペースで **[スペース管理者]** ロールを持つアカウントでサインインする必要があります。
**重要**
リポジトリ拡張機能をインストールすると、CodeCatalyst にリンクするすべてのリポジトリのコードがインデックス化され、CodeCatalyst に保存されます。これにより、コードが CodeCatalyst で検索できるようになります。CodeCatalyst でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については、「*Amazon CodeCatalyst ユーザーガイド*」の「[Data protection](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)」を参照してください。
**CodeCatalyst カタログから拡張機能をインストールするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 検索バーの横にある上部のメニューバーの **[カタログ]** アイコンをクリックして、CodeCatalyst カタログに移動します。「**GitHub リポジトリ**」、「**Bitbucket リポジトリ**」、「**GitLab リポジトリ**」、または「**Jira Software**」で検索できます。カテゴリに基づいて拡張機能をフィルタリングすることもできます。
1. (オプション) 拡張機能の名前を選択すると、拡張機能に付与されるアクセス許可など、拡張機能の詳細が表示されます。
1. **[インストール]** を選択します。拡張機能に必要なアクセス許可を確認し、続行する場合は、**[インストール]** を再度選択します。
拡張機能をインストールすると、インストールされた拡張機能の詳細ページが表示されます。拡張機能の詳細は、各タブで確認できます。詳細ページでは、必要に応じて拡張機能の追加設定を行うこともできます。
# スペースの拡張機能をアンインストールする
CodeCatalyst スペースに以前インストールした拡張機能をアンインストールできます。拡張機能をアンインストールすると、その拡張機能に関連するリソースが CodeCatalyst スペースまたはプロジェクトから削除される場合があります。
**重要**
拡張機能をアンインストールするには、スペースの**スペース管理者**ロールを持っているアカウントでサインインする必要があります。
**CodeCatalyst スペースから拡張機能をアンインストールするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 次のいずれかを実行して、スペースにインストールされている拡張機能の一覧を表示します。
1. **[設定]** を選択し、**[インストールされている拡張機能]** を選択します。
1. トップメニューで **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択します。
1. アンインストールする拡張機能で **[設定]** を選択します。
1. 拡張機能の詳細ページで **[アンインストール]** を選択します。
1. **[拡張機能のアンインストール]** ダイアログボックスで情報を確認します。手順に従い、**[アンインストール]** を選択して拡張機能をアンインストールします。
# GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、および Jira サイト CodeCatalyst に接続
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用するか、CodeCatalyst で Jira プロジェクトを管理するには、まずサードパーティーソースを CodeCatalyst スペースに接続する必要があります。拡張機能とその機能の詳細については、「[利用可能なサードパーティー拡張機能](extensions.md#extensions-types)」を参照してください。
**重要**
GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、または Jira サイトを CodeCatalyst スペースに接続するには、サードパーティーソースの管理者と CodeCatalyst **[スペース管理者]**の両方である必要があります。
**注記**
GitHub アカウントへの接続を使用している場合は、CodeCatalyst ID と GitHub ID 間の ID マッピングを確立するための個人用接続を作成する必要があります。詳細については、「[個人用接続](concepts.md#personal-connection-concept)」および「[個人接続を使用して GitHub リソースにアクセスする](ipa-settings-connections.md)」を参照してください。
**GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、または Jira サイトを CodeCatalyst に接続するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 次のいずれかを実行して、スペースにインストールされている拡張機能の一覧を表示します。
1. **[設定]** を選択し、**[インストールされている拡張機能]** を選択します。
1. トップメニューで **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択します。
1. 設定する拡張機能の 1 つとして、**[設定]** を選択します。**[GitHub リポジトリ]** 、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]**、または **[Jira Software]** を選択します。
1. 設定するサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub アカウントに接続します。
1. **[接続済み GitHub アカウント]** タブで、**[GitHub アカウントを接続]** を選択して、GitHub の外部サイトに移動します。
1. GitHub 認証情報を使用して GitHub アカウントにサインインし、Amazon CodeCatalyst をインストールするアカウントを選択します。
**ヒント**
以前に GitHub アカウントをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の GitHub スペースのメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログボックスが表示されます。1 つの GitHub スペースのみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。リポジトリへのアクセスを許可するアプリケーションを設定し、**[保存]** を選択します。**[保存]** ボタンがアクティブでない場合は、設定を変更してから再試行してください。
1. CodeCatalyst で現在と今後のすべてのリポジトリにアクセスできるようにすることを選択するか、または CodeCatalyst で使用する特定の GitHub リポジトリを選択します。デフォルトのオプションでは、CodeCatalyst によってアクセスされる今後のリポジトリなど、GitHub アカウントにすべての GitHub リポジトリが含まれます。
1. CodeCatalyst に付与されているアクセス許可を確認してから、**[インストール]** を選択します。
GitHub アカウントを CodeCatalyst に接続すると、**[GitHub リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された GitHub アカウントとリンクされた GitHub リポジトリを表示および管理できます。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースに接続します。
1. **[Connected Bitbucket ワークスペース]** タブで、**[Connect Bitbucket ワークスペース]** を選択して Bitbucket の外部サイトに移動します。
1. Bitbucket 認証情報を使用して Bitbucket ワークスペースにサインインし、CodeCatalyst に付与されたアクセス許可を確認します。
1. **[ワークスペースの認証]** ドロップダウンメニューから、CodeCatalyst へのアクセスを許可する Bitbucket ワークスペースを選択し、**[アクセスを許可] ** を選択します。
**ヒント**
以前に Bitbucket ワークスペースをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。複数の Bitbucket ワークスペースのメンバーまたは共同作業者である場合は、拡張機能をインストールする場所を尋ねるダイアログが表示されます。1 つの Bitbucket ワークスペースのみに属している場合は、Amazon CodeCatalyst アプリケーションの設定ページが表示されます。ワークスペースのアクセスを許可するアプリケーションを設定し、**[アクセスを許可]** を選択します。**[アクセスを許可]** ボタンがアクティブでない場合は、設定を変更してから、再試行してください。
Bitbucket ワークスペースを CodeCatalyst に接続すると、**[Bitbucket リポジトリ]** 拡張機能の詳細ページに移動します。このページでは、接続された Bitbucket ワークスペースとリンクされた Bitbucket リポジトリを表示および管理できます。
+ **GitLab リポジトリ**: GitLab ユーザーに接続します。
1. **[GitLab ユーザーを接続]** を選択して、GitLab の外部サイトに移動します。
1. GitLab 認証情報を使用して GitLab ユーザーにログインし、CodeCatalyst に付与されたアクセス許可を確認します。
**ヒント**
以前に GitLab ユーザーをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、CodeCatalyst コンソールに戻ります。
1. **GitLab の AWS コネクタの承認**を選択します。
GitLab ユーザーを CodeCatalyst に接続すると、**GitLab リポジトリ**拡張機能の詳細ページに移動します。このページでは、接続された GitLab ユーザーと、リンクされた GitLab プロジェクトリポジトリを表示および管理できます。
+ **[Jira Software]**: Jira サイトを接続します。
1. **[Connected Jira サイト]** タブで、**[Connect Jira サイト]** を選択して、Atlassian Marketplace の外部サイトに移動します。
1. **[今すぐ取得]** を選択して、Jira サイトへの CodeCatalyst のインストールを開始します。
**注記**
以前に CodeCatalyst を Jira サイトにインストールした場合は、通知が届きます。**[使用を開始]** を選択し、最終ステップに進みます。
1. ロールに応じて、次のいずれかを実行します。
1. Jira サイト管理者の場合は、サイトのドロップダウンメニューから、Jira サイトを選択して CodeCatalyst アプリケーションをインストールし、**[アプリをインストール]** を選択します。
**注記**
Jira サイトが 1 つある場合、このステップは表示されず、自動的に次のステップに移動します。
1.
1. Jira 管理者でない場合は、サイトのドロップダウンメニューから、Jira サイトを選択して CodeCatalyst アプリケーションをインストールし、**[アプリをリクエスト]** を選択します。Jira アプリケーションのインストールの詳細については、「[アプリケーションをインストールできるユーザー](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)」を参照してください。
1. CodeCatalyst を入力テキストフィールドに入力するか、デフォルトのテキストを保持する必要がある理由を入力し、**[リクエストを送信]** を選択します。
1. アプリケーションのインストール時に CodeCatalyst によって実行されたアクションを確認し、**[今すぐ取得]** を選択します。
1. アプリケーションをインストールしたら、**[CodeCatalyst に戻る]** を選択して CodeCatalyst に戻ります。
Jira サイトを CodeCatalyst に接続したら、**[Jira Software]** 拡張機能の詳細ページの **[Connected Jira サイト]** タブで接続されたサイトを表示できます。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用したり、CodeCatalyst で Jira の問題を管理したりする必要がなくなった場合は、サードパーティーソースを切断できます。GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーが切断されると、サードパーティーリポジトリのイベントはワークフロー実行を開始せず、CodeCatalyst 開発環境でこれらのリポジトリを使用することはできません。Jira サイトが切断されると、サイトのプロジェクトで発生した Jira の問題は CodeCatalyst プロジェクトで利用できなくなり、CodeCatalyst の **[問題]** が再び発行プロバイダーになります。詳細については、「[GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、Jira サイトの CodeCatalyst の切断](extensions-disconnect.md)」を参照してください。
# GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、Jira サイトの CodeCatalyst の切断
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用したり、CodeCatalyst で Jira の問題を管理したりする必要がなくなった場合は、サードパーティーソースを切断できます。GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーが切断されると、リポジトリのイベントはワークフロー実行を開始せず、CodeCatalyst 開発環境でこれらのリポジトリを使用することはできません。Jira サイトが切断されると、サイトのプロジェクトで発生した Jira の問題は CodeCatalyst プロジェクトで利用できなくなり、CodeCatalyst の **[問題]** が再び発行プロバイダーになります。
**注記**
GitHub アカウントを切断するには、まずそのアカウントからリンクされたすべての GitHub リポジトリのリンクを解除する必要があります。
Bitbucket ワークスペースを切断するには、まず、リンクされたすべての Bitbucket リポジトリをそのワークスペースからリンク解除する必要があります。
GitLab ユーザーを切断するには、まず、リンクされたすべての GitLab プロジェクトリポジトリをそのワークスペースからリンク解除する必要があります。
Jira サイトを切断するには、まず、リンクされたすべての Jira プロジェクトをそのアカウントからリンク解除する必要があります。
詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
**GitHub プロジェクト、Bitbucket ワークスペース、GitLab ユーザー、または Jira サイトを切断するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 次のいずれかを実行して、スペースにインストールされている拡張機能の一覧を表示します。
1. **[設定]** を選択し、**[インストールされている拡張機能]** を選択します。
1. トップメニューで **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択します。
1. 設定する拡張機能の 1 つとして、**[設定]** を選択します。**[GitHub リポジトリ]** 、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]**、または **[Jira Software]** を選択します。
1. 設定するサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub アカウントを切断します。
**[接続された GitHub アカウント]** タブで、切断する GitHub アカウントを選択し、**[GitHub アカウントの切断]** を選択します。
+ **Bitbucket リポジトリ**: Bitbucket ワークスペースを切断します。
**[接続された Bitbucket ワークスペース]** タブで、切断する Bitbucket ワークスペースを選択し、**[Bitbucket ワークスペースを切断]** を選択します。
+ **GitLab リポジトリ**: GitLab ユーザーを切断します。
**[接続された GitLab ユーザー]** タブで、切断する GitLab ユーザーを選択し、**[GitLab ユーザーを切断]** を選択します。
+ **Jira Software**: Jira サイトに Disonnect します。
**[切断された Jira サイト]** タブで、切断する Jira サイトを選択し、次に **[切断された Jira サイト]** を選択します。
1. **[切断]** ダイアログボックスで、アカウントを切断した場合の影響を確認します。
1. テキスト入力フィールドに「**disconnect**」と入力し、**[切断]** を選択します。
# CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク
GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリお使用する前、または Jira プロジェクトを管理する前には、そのリポジトリやプロジェクトが属するサードパーティのソースと CodeCatalyst スペースを接続する必要があります。詳細については、「[GitHub アカウント、Bitbucket ワークスペース、GitLab ユーザー、および Jira サイト CodeCatalyst に接続](extensions-connect.md)」を参照してください。
ワークフローでは、リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用できます。ここで、リンクされたリポジトリのイベントは、ワークフロー設定に応じてコードをビルド、テスト、またはデプロイするワークフローを開始します。リンクされた GitHub または Bitbucket リポジトリを使用するワークフローのワークフロー設定ファイルは、リンクされたリポジトリに保存されます。リンクされたリポジトリは、開発環境とともに使用して、リンクされたリポジトリ内のファイルを作成、更新、削除することもできます。GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを CodeCatalyst **[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、または **[GitLab リポジトリ]** 拡張機能の詳細ページから、またはプロジェクト自体の **[コード]** の **[ソースリポジトリ]** ビューにリンクできます。
**重要**
**寄稿者**は、GitHub リポジトリまたは Bitbucket リポジトリをリンクすることはできますが、サードパーティーリポジトリのリンクを解除できるのは**スペース管理者**または**プロジェクト管理者**のみです。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
**重要**
リポジトリ拡張機能をインストールすると、CodeCatalyst にリンクするリポジトリには、コードのインデックスが作成され CodeCatalyst に保存されます。これにより、コードが CodeCatalyst で検索できるようになります。CodeCatalyst でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については、「*Amazon CodeCatalyst ユーザーガイド*」の「[データ保護](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)」を参照してください。
**重要**
CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。
ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。
リンクされた Jira プロジェクトを使用して、問題を管理し、CodeCatalyst プルリクエストを Jira 問題にリンクできます。プルリクエストの概要ステータスと、関連付けられた CodeCatalyst ワークフローイベントのステータスが Jira 問題に反映されます。
**重要**
Jira プロジェクトを CodeCatalyst プロジェクトにリンクするには、CodeCatalyst **スペース管理者**または CodeCatalyst **プロジェクト管理者**である必要があります。
**注記**
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、スペース内の 1 つの CodeCatalyst プロジェクトにのみリンクできます。
CodeCatalyst プロジェクトでは、空の GitHub リポジトリまたはアーカイブされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用することはできません。
CodeCatalyst プロジェクトのリポジトリと同じ名前の GitHub リポジトリ、Bitbucket リポジトリ、または GitLab リポジトリをリンクすることはできません。
**GitHub リポジトリ**拡張機能は GitHub Enterprise Server リポジトリと互換性がありません。
**[Bitbucket リポジトリ]** 拡張機能は Bitbucket データセンターリポジトリと互換性がありません。
**[GitLab リポジトリ]** 拡張機能は GitLab セルフマネージドプロジェクトリポジトリと互換性がありません。
リンクされたリポジトリでは、**説明を記述する**機能や**コメントを要約する**機能は使用できません。これらの機能は、CodeCatalyst のプルリクエストでのみ使用できます。
CodeCatalyst プロジェクトは、1 つの Jira プロジェクトにのみリンクできます。Jira プロジェクトは、複数の CodeCatalyst プロジェクトにリンクできます。
**Topics**
+ [接続されたサードパーティープロバイダーからのリソースのリンク](#extensions-link-resources)
+ [CodeCatalyst プロジェクトの作成中にサードパーティーリポジトリをリンクする](#extensions-link-repositories-creation)
## 接続されたサードパーティープロバイダーからのリソースのリンク
**拡張機能の詳細ページから、GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクします。**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 次のいずれかを実行して、スペースにインストールされている拡張機能のリストを表示します。
1. **[設定]** を選択し、**[インストールされている拡張機能]** を選択します。
1. トップメニューで **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択します。
1. 設定する拡張機能の 1 つとして、**[設定]** を選択します。**[GitHub リポジトリ]** 、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]**、または **[Jira Software]** を選択します。
1. 設定するサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub リポジトリをリンクします。
1. **[リンクされた GitHub リポジトリ]** タブで、**[GitHub リポジトリをリンク]** を選択します。
1. **[GitHub アカウント]** ドロップダウンメニューから、リンクするリポジトリを含む GitHub アカウントを選択します。
1. **[GitHub リポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. (オプション) リポジトリの一覧に GitHub リポジトリが表示されない場合は、GitHub の Amazon CodeCatalyst アプリケーションでリポジトリアクセス用に設定されていない可能性があります。接続されたアカウントの CodeCatalyst で使用できる GitHub リポジトリを設定できます。
1. [[GitHub]](https://github.com/) アカウントに移動し、**[設定]** > **[アプリケーション]** の順に選択します。
1. **[インストールされた GitHub アプリ]** タブで、Amazon CodeCatalyst アプリケーションの **[設定]** を選択します。
1. CodeCatalyst でリンクする GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します。
+ 現在および今後のすべてのリポジトリへのアクセスを許可するには、**[すべてのリポジトリ]** を選択します。
+ 特定のリポジトリへのアクセスを許可するには、**[リポジトリのみを選択]** を選択し、**[リポジトリを選択]** ドロップダウンメニューで、CodeCatalyst でリンクを許可するリポジトリを選択します。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、GitHub リポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で GitHub リポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **Bitbucket リポジトリ**: Bitbucket リポジトリをリンクします。
1. **[リンクされた Bitbucket リポジトリ]** タブで、**[Bitbucket リポジトリをリンク]** を選択します。
1. **[Bitbucket ワークスペース]** ドロップダウンメニューから、リンクするリポジトリを含む Bitbucket ワークスペースを選択します。
1. **[Bitbucket リポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、Bitbucket リポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で Bitbucket リポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **[GitLab リポジトリ]**: GitLab プロジェクトリポジトリをリンクします。
1. **[Linked GitLab プロジェクトリポジトリ]** タブで、**[Link GitLab プロジェクトリポジトリ]** を選択します。
1. **[GitLab ユーザー]** ドロップダウンメニューから、リンクするプロジェクトリポジトリを含む GitLab ユーザーを選択します。
1. **[GitHub プロジェクトリポジトリ]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、GitLab プロジェクトリポジトリをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
CodeCatalyst で GitLab プロジェクトリポジトリを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。プロジェクトリポジトリのリンクが解除されると、そのプロジェクトリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのプロジェクトリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
+ **Jira Software**: Jira プロジェクトをリンクします。
1. **[リンクされた Jira プロジェクト]** タブで、**[Jira プロジェクトをリンク]** を選択します。
1. **[Jira サイト]** ドロップダウンメニューから、リンクするプロジェクトを含む Jira サイトを選択します。
1. **[Jira プロジェクト]** ドロップダウンメニューから、CodeCatalyst プロジェクトにリンクするプロジェクトを選択します。
1. **[CodeCatalyst プロジェクト]** ドロップダウンメニューから、Jira プロジェクトをリンクする CodeCatalyst プロジェクトを選択します。
1. [**Link (リンク)**] を選択します。
Jira プロジェクトが CodeCatalyst プロジェクトにリンクされると、CodeCatalyst の問題へのアクセスは完全に無効になり、CodeCatalyst ナビゲーションペインの **[問題]** は、Jira プロジェクトにリンクする **[Jira の問題]** 項目に置き換えられます。
![\[CodeCatalyst の問題は、ナビゲーションペインでリンクされた Jira の問題に置き換えられました。\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
CodeCatalyst で Jira プロジェクトを使用しない場合は、CodeCatalyst プロジェクトからリンクを解除できます。Jira プロジェクトがリンク解除されると、Jira の問題は CodeCatalyst プロジェクトで利用できなくなり、CodeCatalyst の **[問題]** が再び問題プロバイダーになります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
**プロジェクトのソースリポジトリページから、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを CodeCatalyst プロジェクトにリンクするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. ナビゲーションペインで **[コード]** を選択してから、**[ソースリポジトリ]** を選択します。
1. **[リポジトリを追加]**、**[リポジトリをリンク]** の順に選択します。
1. **[リポジトリプロバイダー]** ドロップダウンメニューで、**[GitHub]**、**[Bitbucket]**、または **[GitLab]** のいずれかのサードパーティリポジトリプロバイダーを選択します。
1. リンクするサードパーティリポジトリプロバイダーに応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub リポジトリをリンクします。
1. **[Github アカウント]** ドロップダウンメニューで、リンクするリポジトリを含む Github アカウントを選択します。
1. **[Github リポジトリ]** ドロップダウンメニューで、CodeCatalyst プロジェクトをリンクする Github リポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリは Amazon CodeCatalyst で別のプロジェクトに既にリンクされているため、リンクできません。
1. (オプション) リポジトリの一覧に GitHub リポジトリが表示されない場合は、GitHub の Amazon CodeCatalyst アプリケーションでリポジトリアクセス用に設定されていない可能性があります。接続されたアカウントの CodeCatalyst で使用できる GitHub リポジトリを設定できます。
1. [[GitHub]](https://github.com/) アカウントに移動し、**[設定]** > **[アプリケーション]** の順に選択します。
1. **[インストールされた GitHub アプリ]** タブで、Amazon CodeCatalyst アプリケーションの **[設定]** を選択します。
1. CodeCatalyst でリンクする GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します。
+ 現在および今後のすべてのリポジトリへのアクセスを許可するには、**[すべてのリポジトリ]** を選択します。
+ 特定のリポジトリへのアクセスを許可するには、**[リポジトリのみを選択]** を選択し、**[リポジトリを選択]** ドロップダウンメニューで、CodeCatalyst でリンクを許可するリポジトリを選択します。
+ **Bitbucket リポジトリ**: Bitbucket リポジトリをリンクします。
1. **[Bitbucket ワークスペース]** ドロップダウンメニューで、リンクするリポジトリを含む Bitbucket ワークスペースを選択します。
1. **[Bitbucket リポジトリ]** ドロップダウンメニューで CodeCatalyst プロジェクトをリンクする Bitbucket リポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリは Amazon CodeCatalyst で別のプロジェクトに既にリンクされているため、リンクできません。
+ **[GitLab リポジトリ]**: GitLab プロジェクトリポジトリをリンクします。
1. **[GitLab ユーザー]** ドロップダウンメニューから、リンクするプロジェクトリポジトリを含む GitLab ユーザーを選択します。
1. **[Github プロジェクトリポジトリ]** ドロップダウンメニューで、CodeCatalyst プロジェクトをリンクする Github プロジェクトリポジトリを選択します。
**ヒント**
リポジトリの名前がグレーアウトされている場合、そのリポジトリは Amazon CodeCatalyst で別のプロジェクトに既にリンクされているため、リンクできません。
1. [**Link (リンク)**] を選択します。
Github リポジトリ、Bitbucket リポジトリまたは CodeCatalyst の GitLab プロジェクトリポジトリを使用する必要がなくなった場合は、CodeCatalyst プロジェクトからそれらのリンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、CodeCatalyst 開発環境でそのリポジトリを使用することはできません。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除](extensions-unlink.md)」を参照してください。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを CodeCatalyst プロジェクトにリンクしたら、CodeCatalyst ワークフローと開発環境で使用できます。リンクされたリポジトリは、Amazon Q Developer、ブループリントなどでも使用できます。詳細については、「[サードパーティーリポジトリイベント後にワークフローを自動的に開始](extensions-workflow-repositories.md)」および「[開発環境の作成](devenvironment-create.md)」を参照してください。
Jira プロジェクトを CodeCatalyst プロジェクトにリンクし、プルリクエストをリンクすると、CodeCatalyst の更新が Jira プロジェクトに反映されます。プルリクエストを Jira の問題にリンクする詳細については、「[Jira の問題を CodeCatalyst プルリクエストにリンクする](link-jira-issues-pull-requests.md)」を参照してください。Jira での CodeCatalyst イベントの表示の詳細については、「[Jira 問題における CodeCatalyst イベントの表示](view-codecatalyst-events-jira.md)」を参照してください。
## CodeCatalyst プロジェクトの作成中にサードパーティーリポジトリをリンクする
新しい CodeCatalyst プロジェクトを作成するときに、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを新しい CodeCatalyst プロジェクトにリンクできます。詳細については、「[リンクされたサードパーティーリポジトリを使用したプロジェクトの作成](projects-create.md#projects-create-3p-repo)」を参照してください。
# CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用したり、CodeCatalyst で Jira プロジェクトを管理したりする必要がなくなった場合は、CodeCatalyst プロジェクトからリポジトリまたはプロジェクトのリンクを解除できます。
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリのリンクを解除しても、リポジトリは削除されず、変更も行われません。リンクされたリポジトリに保存されているワークフロー設定ファイルは削除されません。ただし、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリのリンクを解除すると、そのリポジトリ内のイベントはワークフロー実行を開始せず、開発環境でリポジトリを使用することはできません。GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを CodeCatalyst **[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、または **[GitLab リポジトリ]** 拡張機能の詳細ページから、またはプロジェクト自体の **[コード]** の **[ソースリポジトリ]** ビューからリンク解除できます。
Jira プロジェクトのリンクを解除しても、計画項目や開発情報を含むプロジェクトが削除されたり、変更を加えたりすることはありません。ただし、Jira プロジェクトのリンクを解除すると、プロジェクトの Jira の問題は CodeCatalyst プロジェクトにリンクできなくなり、CodeCatalyst の **[問題]** は再び問題プロバイダーになります。
**重要**
GitHub リポジトリ、Bitbucket リポジトリ、または Gitlab プロジェクトリポジトリを CodeCatalyst プロジェクトからリンク解除するには、**[スペース管理者]** または **[プロジェクト管理者]** である必要があります。
**拡張機能の詳細ページから、GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトでリンク解除します。**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動します。
1. 次のいずれかを実行して、スペースにインストールされている拡張機能の一覧を表示します。
1. **[設定]** を選択し、**[インストールされている拡張機能]** を選択します。
1. トップメニューで **[カタログ]** アイコン ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) を選択します。
1. 設定する拡張機能の 1 つとして、**[設定]** を選択します。**[GitHub リポジトリ]** 、**[Bitbucket リポジトリ]**、**[GitLab リポジトリ]**、または **[Jira Software]** を選択します。
1. 設定するサードパーティー拡張機能に応じて、次のいずれかを実行します。
+ **GitHub リポジトリ**: GitHub リポジトリのリンクを解除します。
**[GitHub リポジトリ]** タブで、リンクを解除する GitHub リポジトリを選択し、**[GitHub リポジトリのリンクを解除]** を選択します。
+ **Bitbucket リポジトリ**: Bitbucket リポジトリのリンクを解除します。
**[Bitbucket リポジトリ]** タブで、リンクを解除する Bitbucket リポジトリを選択し、**[Bitbucket リポジトリのリンクを解除]** を選択します。
+ **GitLab リポジトリ**: GitLab プロジェクトリポジトリのリンクを解除します。
**[GitLab プロジェクトリポジトリ]** タブで、リンクを解除する GitLab プロジェクトリポジトリを選択し、**[GitLab プロジェクトリポジトリのリンクを解除]** を選択します。
+ **Jira Software**: Jira プロジェクトのリンクを解除します。
**[Jira プロジェクト]** タブで、リンクを解除する Jira プロジェクトを選択し、次に **[Jira プロジェクトのリンク解除]** を選択します。
1. **[リンク解除]** ダイアログボックスで、リポジトリのリンク解除の効果を確認します。
1. テキスト入力フィールドに「**unlink**」を入力し、**[リンク解除]** を選択します。
**CodeCatalyst プロジェクトの GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをソースリポジトリページからリンク解除するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. ナビゲーションペインで **[コード]** を選択してから、**[ソースリポジトリ]** を選択します。
1. リンクを解除するリポジトリのラジオボタンを選択し、**[リポジトリのリンクを解除]** を選択します。
1. ダイアログボックスで情報を確認します。手順に従って、**[リンク解除]** を選択してリポジトリのリンクを解除します。
# CodeCatalyst でのサードパーティーリポジトリの表示と Jira の問題の検索
GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをリンクした後、CodeCatalyst でそれらを表示してリソースを確認および設定できます。CodeCatalyst でリンクされた Jira の問題を検索することもできます。
**Topics**
+ [CodeCatalyst でのサードパーティーリポジトリの表示](#extensions-view-repositories)
+ [CodeCatalyst での Jira の問題の検索](#extensions-search-issues)
## CodeCatalyst でのサードパーティーリポジトリの表示
リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、プロジェクトのソースリポジトリの一覧、または **[GitHub リポジトリ]**、**[Bitbucket リポジトリ]**、もしくは **[GitLab リポジトリ]** 拡張機能の詳細ページから表示できます。リポジトリの一覧からそれらを選択しても、CodeCatalyst では開きません。代わりに、サードパーティーのリポジトリプロバイダーで開き、リンクされたリポジトリでコードを表示して操作できます。
**CodeCatalyst にリンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. ナビゲーションペインで **[コード]** を選択してから、**[ソースリポジトリ]** を選択します。
**リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを拡張機能の詳細ページから表示する方法**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst スペースに移動し、**[インストールされた拡張機能]** タブを選択します。
1. 表示するサードパーティーリポジトリに応じて、次のいずれかを実行します。
+ **[GitHub リポジトリ]** で、**[設定]** を選択し、**「リンクされた GitHub リポジトリ**」を選択して、CodeCatalyst スペース内の CodeCatalyst プロジェクトに接続されているすべての GitHub リポジトリを表示します。
+ **[Bitbucket リポジトリ]** で、**[設定]** を選択し、**「リンクされた Bitbucket リポジトリ**」を選択して、CodeCatalyst スペース内の CodeCatalyst プロジェクトに接続されているすべての Bitbucket リポジトリを表示します。
+ **[GitLab リポジトリ]** で、**[設定]** を選択し、**[リンクされた GitLab プロジェクトリポジトリ]** を選択して、CodeCatalyst スペース内の CodeCatalyst プロジェクトに接続されたすべての GitLab プロジェクトリポジトリを表示します。
CodeCatalyst プロジェクトにリンクされている GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリが一覧に表示されます。GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを選択して、サードパーティーリポジトリプロバイダー内のファイルを表示および編集します。
**注記**
ワークフローがソースアクションで GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用する場合、ビジュアルエディタのワークフロー YAML または CodeCatalyst の YAML エディタに加えた変更は、自動的にコミットされ、サードパーティーリポジトリにプッシュされます。
## CodeCatalyst での Jira の問題の検索
Jira プロジェクトをリンクした後、CodeCatalyst グローバル検索バーを使用して、リンクされた Jira プロジェクトで問題を検索できます。プルリクエストから問題にリンクしながら、CodeCatalyst で Jira の問題を検索することもできます。Jira の問題と CodeCatalyst プルリクエストのリンクの詳細については、「[Jira の問題を CodeCatalyst プルリクエストにリンクする](link-jira-issues-pull-requests.md)」を参照してください。
**リンクされた Jira プロジェクトで Jira の問題を検索するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. グローバル検索バーで、プルリクエストにリンクする問題や Jira の問題がないか、リンクされた Jira プロジェクトを検索します。
# サードパーティーリポジトリイベント後にワークフローを自動的に開始
リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリをワークフローのソースとして使用できます。このワークフローでは、リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリ内の指定されたブランチへの変更が自動的にワークフロー実行を開始します。
*ワークフロー*は、継続的統合と継続的配信 (CI/CD) システムの一部としてコードをビルド、テスト、デプロイする方法を説明する自動手順です。ワークフローは、ワークフローの実行中に実行する一連のステップまたは*アクション*を定義します。ワークフローは、ワークフローを開始するイベント、または*トリガー*も定義します。ワークフローを設定するには、CodeCatalyst コンソールの[ビジュアルエディタまたは YAML エディタ](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)を使用して*ワークフロー定義ファイル*を作成します。
**ヒント**
プロジェクトでワークフローを使用する方法を簡単に確認するには、[ブループリントを使用してプロジェクトを作成](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)します。各ブループリントは、レビュー、実行、実験可能な機能するワークフローをデプロイします。
リンクされた GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用するようにワークフローを設定すると、ワークフロー設定ファイルはその GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリに保存されます。ワークフロー設定は、ワークフロー名、トリガー、リソース、アーティファクト、アクションを定義する YAML ファイルです。ワークフロー設定ファイルの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」を参照してください。
ワークフロー設定ファイルは、GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリの `./codecatalyst/workflows/` ディレクトリにある必要があります。
ワークフローエディタを使用して、ワークフローを作成および設定できます。詳細については、「[初めてのワークフロー](workflows-getting-started.md)」および「[ワークフローへのソースリポジトリの接続](workflows-sources.md)」を参照してください。
## ワークフロー実行を開始するためのトリガーの追加
コードが GitHub または Bitbucket リポジトリの指定されたブランチにプッシュされたときに自動的に実行を開始するように CodeCatalyst ワークフローを設定できます。ワークフローを自動的に開始するには、ワークフロー設定ファイルの `Triggers` セクションにトリガーを追加します。
### 例: シンプルなコードプッシュトリガー
次の例は、ソースリポジトリ内のブランチにコードがプッシュされるたびにワークフローの実行を開始するトリガーを示しています。
```
Triggers:
- Type: PUSH
```
### 例: シンプルなプルリクエストトリガー
次の例は、ソースリポジトリ内のブランチに対してプルリクエストが作成されるたびにワークフローの実行を開始するトリガーを示しています。
```
Triggers:
- Type: PULLREQUEST
Events:
- OPEN
```
詳細については、「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。
# サードパーティーリポジトリプロバイダーによる IP アクセスの制限
ルールまたは設定を設定することで、IP アドレスに基づいて GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリへのアクセスを制限できます。これを行うには、サードパーティープロバイダーの設定またはアクセスコントロール機能を使用します。
使用しているサードパーティーリポジトリプロバイダーに応じて、次のいずれかを参照してください。
+ Amazon CodeCatalyst **[GitHub リポジトリ]** 拡張機能は、[[GitHub Enterprise Cloud IP アクセス制限]](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization) と互換性があります。特定の IP アドレスへのアクセスを制限するように GitHub Enterprise Cloud 組織を設定する場合、[GitHub アプリが許可リストを設定できるようにする](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)こともできます。これにより、CodeCatalyst は IP アドレスを GitHub に自動的に登録できます。または、[CodeCatalyst IP アドレス を手動で追加](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)することもできます。
+ Amazon CodeCatalyst **[Bitbucket リポジトリ]** 拡張機能は、[[Bitbucket Cloud Premium アクセス制限]](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/) と互換性があります。特定の IP アドレスへのアクセスを制限するように Bitbucket Cloud Premium ワークスペースを設定するときは、[一連の IP アドレスとして IP アドレスまたはネットワークブロックを許可リストに追加](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/#Allowlisting-IP-addresses)することもできます。
+ Amazon CodeCatalyst **[GitLab リポジトリ]** 拡張機能は、[[GitLab IP アドレス制限]](https://docs.gitlab.com/ee/administration/reporting/ip_addr_restrictions.html) と互換性があります。特定の IP アドレスへのアクセスを制限するように GitLab Premium または Ultimate グループを設定するときは、[一連の IP アドレスとして IP アドレスまたはネットワークブロックを許可リストに追加](https://docs.gitlab.com/ee/user/group/access_and_permissions.html)することもできます。
CodeCatalyst IP アドレスがサードパーティーリポジトリの許可リストにない場合、Amazon CodeCatalyst アプリはサードパーティーリポジトリにアクセスできなくなります。詳細については、「[サードパーティーのリポジトリ拡張機能で使用される IP アドレス](#codecatalyst-ip-address)」を参照してください。
## サードパーティーのリポジトリ拡張機能で使用される IP アドレス
以下の IP アドレスは、サードパーティーの拡張機能がサードパーティーのリソースにアクセスするために使用します。
+ **GitHub リポジトリ**:
```
us-west-2
52.32.242.246
54.148.176.49
35.164.118.94
eu-west-1
34.241.64.10
34.246.255.80
3.248.38.7
```
+ **[Bitbucket リポジトリ]** と **[GitLab リポジトリ]**:
```
us-west-2
35.160.210.199
54.71.206.108
54.71.36.205
eu-west-1
34.242.64.82
52.18.37.201
54.77.75.62
```
# ワークフローが失敗した場合のサードパーティーマージのブロック
GitHub または Bitbucket リポジトリを CodeCatalyst にリンクした後、プルリクエストに CodeCatalyst ワークフローを追加できます。同様に、GitLab プロジェクトリポジトリを CodeCatalyst にリンクした後、マージリクエストに CodeCatalyst ワークフローを追加できます。1 つ以上のワークフロー実行は特定のコミットで実行でき、CodeCatalyst の各ワークフローの実行ステータスは、GitHub 、Bitbucket、または GitLab のコミットステータスの一部としても反映されます。新しいコミットがプッシュされると、その新しいコミットの新しいワークフロー [[実行ステータス]](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-view-run.html#workflows-view-run-status) が GitHub 、Bitbucket、または GitLab に反映されます。コミットに対してワークフローを再度実行すると、新しいワークフロー実行ステータスによって、そのコミットとワークフローの以前のステータスが上書きされます。
最新のコミットが失敗したワークフロー実行ステータスである場合、GitHub または Bitbucket でブランチ保護ルールを設定してプルリクエストのマージをブロックするか、GitLab でマージリクエストをブロックできます。ブランチ保護ルールでは、最新のコミットのステータスは、GitHub 、Bitbucket、または GitLab のプルリクエストをマージする機能に影響します。ワークフローの詳細については、「[ワークフローの実行](workflows-working-runs.md)」および「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。
使用しているサードパーティーリポジトリプロバイダーに応じて、次を参照してください。
+ **GitHub リポジトリ**: GitHub のドキュメント「[ステータスチェック](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)」と「[保護されたブランチ について](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)」。
+ **Bitbucket リポジトリ**: Bitbucket Cloud で [ブランチアクセス許可を使用](https://confluence.atlassian.com/bitbucketserver/using-branch-permissions-776639807.html)し、[ブランチアクセス許可を使用して制御する](https://bitbucket.org/blog/take-control-with-branch-restrictions)ための Bitbucket のドキュメント。
+ **GitLab リポジトリ**: [[自動マージ]](https://docs.gitlab.com/ee/user/project/merge_requests/auto_merge.html) と [[保護されたブランチ]](https://docs.gitlab.com/ee/user/project/protected_branches.html) に関する GitLab のドキュメント。
# Jira の問題を CodeCatalyst プルリクエストにリンクする
CodeCatalyst ソースリポジトリで作成されたプルリクエストを Jira の問題にリンクできます。Jira の問題をリンクすると、問題はプルリクエストのプロパティとして表示されます。その結果、プルリクエストイベント、ワークフローイベント、デプロイイベントが Jira に送信され、Jira の問題に追加されます。プルリクエストは、1 つまたは複数の Jira の問題にリンクできます。CodeCatalyst ソースリポジトリにあるプルリクエストのみをリンクできます。GitHub などのサードパーティーリポジトリにあるプルリクエストはリンクできません。Jira の問題をプルリクエストにリンクする前に、Jira プロジェクトを CodeCatalyst プロジェクトにリンクする必要があります。Jira プロジェクトを CodeCatalyst プロジェクトにリンクする方法については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。
**注記**
CodeCatalyst プロジェクトに 2 つのブランチを持つソースリポジトリがないと、プルリクエストを作成することはできません。プルリクエストの詳細については、「[Working with pull requests in CodeCatalyst](source-pull-requests.md)」を参照してください。
**Jira の問題を CodeCatalyst プルリクエストにリンクするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. ナビゲーションペインで、**[コード]** を選択し、**[プルリクエスト]** を選択します。
1. **[プルリクエストの作成]** を選択して、プルリクエストの詳細を入力します。
1. **[ソースリポジトリ]** のドロップダウンメニューから、プルリクエストをリンクするソースリポジトリを選択します。
1. **[ソースブランチ]** ドロップダウンメニューから、レビュー対象の変更を含むブランチを選択します。
1. **[ターゲットブランチ]** ドロップダウンメニューから、レビュー済みの変更をマージするブランチを選択します。
1. **[プルリクエストのタイトル]** テキスト入力フィールドに、プルリクエストの件名を入力します。
1. **[Jira の問題 - *オプション*]** フィールドで **[問題をリンクする]** を選択し、ドロップダウンを選択し、リンクされた Jira プロジェクトから追加する Jira の問題を検索します。
1. プルリクエストに追加する Jira の問題を選択します。
1. **[作成]** を選択してプルリクエストを送信します。
Jira の問題を CodeCatalyst プルリクエストにリンクすると、プルリクエストの要約が表示されます。要約には、ワークフローの実行、リンクされた問題、必須のレビュアー、オプションのレビュアー、作成者が含まれます。
**注記**
Jira の問題に関連する **[担当者]** と **[作成者]** の情報は、CodeCatalyst では確認できません。
プルリクエストをリンクすると、同期された CodeCatalyst プロジェクトと Jira プロジェクトにより CodeCatalyst の更新が Jira プロジェクトに反映されます。リンクされたプルリクエストのステータスとこのプルリクエストに関連するワークフローイベントは、Jira で表示すると Jira の問題に表示されます。Jira での CodeCatalyst イベントの表示の詳細については、「[Jira 問題における CodeCatalyst イベントの表示](view-codecatalyst-events-jira.md)」を参照してください。
# Jira 問題における CodeCatalyst イベントの表示
CodeCatalyst プロジェクトと Jira プロジェクトがリンクされている場合、プルリクエストの概要ステータスと、関連付けられた CodeCatalyst ワークフローイベントのステータスが Jira 問題に反映されます。例えば、CodeCatalyst でプルリクエストを終了またはマージすると、ステータスの更新は Jira 問題に反映されます。CodeCatalyst プルリクエストに関連する CodeCatalyst ワークフロー CI/CD イベントは同期されるため、ワークフローの実行が成功すると Jira 問題にも送信されます。
**Jira 問題で CodeCatalyst イベントを表示するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. CodeCatalyst プロジェクトに移動します。
1. CodeCatalyst ナビゲーションペインで、**[コード]**、**[プル リクエスト]** の順に選択し、Jira プロジェクトで表示する Jira 問題を持つプルリクエストを選択します。
1. **[追加情報]** ペインで、Jira プロジェクトに表示する Jira 問題を選択します。
1. Jira プロジェクトの **[詳細]** ペインで、**[開発]** に一覧表示されている **[プルリクエスト]** を選択して、プルリクエストの詳細を確認します。
1. (オプション) 最新のビルドを表示するには、**[ビルド]** タブを選択します。
1. (オプション) 開発ステータスを確認するには、**[デプロイ]** タブを選択します。