クイックスタート: 拡張機能のインストール、プロバイダーの接続、および リソースのリンク CodeCatalyst - Amazon CodeCatalyst
ステップ 1: CodeCatalyst カタログからサードパーティー拡張機能をインストールするステップ 2: サードパーティープロバイダーをスペース CodeCatalyst に接続するステップ 3: サードパーティーリソースを CodeCatalyst プロジェクトにリンクする次のステップ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

クイックスタート: 拡張機能のインストール、プロバイダーの接続、および リソースのリンク CodeCatalyst

このチュートリアルでは、次の 3 つのタスクのチュートリアルを提供します。

  1. GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab リポジトリ 、または Jira Software 拡張機能をインストールします。外部サイトでは、サードパーティーリソースに接続して CodeCatalyst アクセスを提供するように求められます。これは次のステップの一環として行われます。

    重要

    GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab リポジトリ 、または Jira Software 拡張機能を CodeCatalyst スペースにインストールするには、スペース管理者ロールを持つアカウントでサインインする必要があります。

  2. GitHub アカウント、Bitbucket ワークスペース、 GitLab ユーザー、または Jira サイトを に接続します CodeCatalyst。

    重要

    GitHub アカウント、Bitbucket ワークスペース、 GitLab ユーザー、または Jira サイトを CodeCatalyst スペースに接続するには、サードパーティーソースの管理者と CodeCatalyst Space 管理者の両方である必要があります。

    重要

    リポジトリ拡張機能をインストールすると、リンク先のリポジトリにはコード CodeCatalyst のインデックスが作成され、 に保存されます CodeCatalyst。これにより、コードは で検索できるようになります CodeCatalyst。でリンクされたリポジトリを使用する際のコードのデータ保護の詳細については CodeCatalyst、「Amazon CodeCatalyst ユーザーガイド」の「データ保護」を参照してください。

    注記

    GitHub アカウントへの接続を使用している場合は、個人接続を作成して、アイデンティティと CodeCatalyst アイデンティティの間にアイデンティティマッピングを確立する必要があります GitHub 。詳細については、「個人用接続」および「個人接続による GitHub リソースへのアクセス」を参照してください。

  3. GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクします。

    重要
    重要

    CodeCatalyst は、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず からリンクを解除し CodeCatalyst、デフォルトブランチを変更してから、再度リンクする必要があります。詳細については、「での GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク CodeCatalyst」を参照してください。

    ベストプラクティスとして、リポジトリをリンクする前に、必ず最新バージョンの拡張機能があることを確認してください。

    注記

    • GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリは、スペース内の 1 CodeCatalyst つのプロジェクトにのみリンクできます。

    • 空の GitHub リポジトリ、アーカイブされたリポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトで CodeCatalyst プロジェクトリポジトリを使用することはできません。

    • GitLab プロジェクト内の GitHub リポジトリと同じ名前のリポジトリ、Bitbucket リポジトリ、または CodeCatalyst プロジェクトリポジトリをリンクすることはできません。

    • GitHub リポジトリ拡張機能は GitHub Enterprise Server リポジトリと互換性がありません。

    • Bitbucket リポジトリ拡張機能は Bitbucket データセンターリポジトリと互換性がありません。

    • GitLab リポジトリ拡張機能は、 GitLab セルフマネージドプロジェクトリポジトリと互換性がありません。

    • リンクされたリポジトリで、自分のコメントの書き込み説明や要約機能を使用することはできません。これらの機能は、 のプルリクエストでのみ使用できます CodeCatalyst。

    • CodeCatalyst プロジェクトは 1 つの Jira プロジェクトにのみリンクできます。Jira プロジェクトは、複数の CodeCatalyst プロジェクトにリンクできます。

GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab リポジトリ拡張をインストールし、 GitHub アカウント、Bitbucket ワークスペース、または GitLab ユーザーに接続し、新しい CodeCatalyst プロジェクトを作成するときにサードパーティーリポジトリをリンクすることもできます。詳細については、「リンクされたサードパーティーリポジトリを使用したプロジェクトの作成」を参照してください。

ステップ 1: CodeCatalyst カタログからサードパーティー拡張機能をインストールする

で thid-party リソースを使用する最初のステップ CodeCatalyst は、 CodeCatalyst カタログからGitHub リポジトリ拡張機能をインストールすることです。拡張機能をインストールするには、使用するサードパーティーリソースの拡張機能を選択して、次のステップを実行します。GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab および リポジトリを使用すると、 GitHub でリポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用できます CodeCatalyst。Jira Software では、 で Jira の問題を管理できます CodeCatalyst。

CodeCatalyst カタログから拡張機能をインストールするには

  1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

  2. CodeCatalyst スペースに移動します。

  3. The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. トップメニューの CodeCatalyst CodeCatalyst カタログアイコンを選択して、カタログに移動します。GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab リポジトリ 、または Jira Software を検索できます。カテゴリに基づいて拡張をフィルタリングすることもできます。

  4. （オプション) 拡張機能のアクセス許可など、拡張機能の詳細を確認するには、拡張機能名を選択します。

  5. [Install] (インストール) を選択します。拡張機能に必要なアクセス許可を確認し、続行する場合は、[インストール] を再度選択します。

拡張機能をインストールすると、拡張機能の詳細ページに移動します。インストールした拡張機能に応じて、接続されたプロバイダーとリンクされたリソースを表示および管理できます。

ステップ 2: サードパーティープロバイダーをスペース CodeCatalyst に接続する

GitHub リポジトリ 、Bitbucket リポジトリ 、GitLab リポジトリ 、または Jira Software 拡張機能をインストールしたら、次のステップは、 GitHub アカウント、Bitbucket ワークスペース、 GitLab プロジェクトリポジトリ、または Jira サイトを CodeCatalyst スペースに接続することです。

GitHub アカウント、Bitbucket ワークスペース、または Jira サイトを に接続するには CodeCatalyst

  • インストールしたサードパーティー拡張機能に応じて、次のいずれかを実行します。

    • GitHub リポジトリ : GitHub アカウントに接続します。

      1. Connected GitHub accounts タブで、Connect GitHub account を選択して の外部サイトに移動します GitHub。

      2. GitHub 認証情報を使用して GitHub アカウントにサインインし、Amazon をインストールするアカウントを選択します CodeCatalyst。

        ヒント

        GitHub 以前にアカウントをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、複数の GitHub 組織のメンバーまたは共同作業者の場合は拡張機能をインストールする場所を尋ねるダイアログボックスが表示され、1 つの GitHub 組織にしか属していない場合は Amazon CodeCatalyst アプリケーションの設定ページが表示されます。許可するリポジトリアクセスのアプリケーションを設定し、 の保存 を選択します。保存ボタンがアクティブでない場合は、設定を変更してから再試行してください。

      3. 現在および将来のすべてのリポジトリへのアクセス CodeCatalyst を許可するか、 で使用する特定の GitHub リポジトリを選択するかを選択します CodeCatalyst。デフォルトのオプションは、 によってアクセスされる将来の GitHub リポジトリを含む、 GitHub アカウント内のすべてのリポジトリを含めることです CodeCatalyst。

      4. に付与されたアクセス許可を確認し CodeCatalyst、「 のインストール」を選択します。

      GitHub アカウントを に接続すると CodeCatalyst、GitHub リポジトリ拡張の詳細ページに移動し、接続された GitHub アカウントとリンクされた GitHub リポジトリを表示および管理できます。

    • Bitbucket リポジトリ : Bitbucket ワークスペースに接続します。

      1. Connected Bitbucket ワークスペースタブで、Connect Bitbucket ワークスペースを選択して Bitbucket の外部サイトに移動します。

      2. Bitbucket 認証情報を使用して Bitbucket ワークスペースにサインインし、 に付与されたアクセス許可を確認します CodeCatalyst。

      3. ワークスペースの承認ドロップダウンメニューから、 CodeCatalyst アクセスを許可する Bitbucket ワークスペースを選択し、アクセス許可 を選択します。

        ヒント

        Bitbucket ワークスペースをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、複数の Bitbucket ワークスペースのメンバーまたは共同作業者の場合は拡張機能をインストールする場所を尋ねるダイアログが表示され、1 つの Bitbucket ワークスペースにのみ属している場合は Amazon CodeCatalyst アプリケーションの設定ページが表示されます。許可するワークスペースアクセスのアプリケーションを設定し、アクセス許可 を選択します。アクセス許可ボタンがアクティブでない場合は、設定を変更してから再試行してください。

      Bitbucket ワークスペースを に接続すると CodeCatalyst、Bitbucket リポジトリ拡張の詳細ページに移動します。このページでは、接続された Bitbucket ワークスペースとリンクされた Bitbucket リポジトリを表示および管理できます。

    • GitLab リポジトリ : GitLab ユーザーに接続します。

      1. Connect GitLab ユーザーを選択して、 の外部サイトに移動します GitLab。

      2. GitLab 認証情報を使用して GitLab ユーザーにサインインし、 に付与されたアクセス許可を確認します CodeCatalyst。

        ヒント

        以前に GitLab ユーザーをスペースに接続したことがある場合、再承認を求めるプロンプトは表示されません。代わりに、 CodeCatalyst コンソールに戻ります。

      3. の AWS コネクタの承認を選択します GitLab。

      ユーザー GitLab を に接続すると CodeCatalyst、GitLab リポジトリ拡張の詳細ページに移動し、接続された GitLab ユーザーとリンクされた GitLab プロジェクトリポジトリを表示および管理できます。

    • Jira Software : Jira サイトを接続します。

      1. Connected Jira サイトタブで、Connect Jira サイトを選択して、Atlassian Marketplace の外部サイトに移動します。

      2. 今すぐ取得を選択して、Jira サイト CodeCatalyst へのインストールを開始します。

        注記

        以前に Jira サイト CodeCatalyst に をインストールした場合は、通知が送信されます。「Get started to be taken to the final step」を選択します。

      3. ロールに応じて、次のいずれかを実行します。

        1. Jira サイト管理者の場合は、サイトのドロップダウンメニューから、 CodeCatalyst アプリケーションをインストールする Jira サイトを選択し、アプリのインストール を選択します。

          注記

          Jira サイトが 1 つある場合、このステップは表示されず、自動的に次のステップに移動します。

          1. Jira 管理者でない場合は、サイトのドロップダウンメニューから、アプリケーションをインストールする CodeCatalyst Jira サイトを選択し、アプリケーション のリクエストを選択します。Jira アプリのインストールの詳細については、「アプリをインストールできるユーザー」を参照してください。

          2. CodeCatalyst 入力テキストフィールドに をインストールする必要がある理由を入力するか、デフォルトのテキストを保持し、リクエストの送信 を選択します。

      4. アプリケーションのインストール CodeCatalyst 時に によって実行されたアクションを確認し、今すぐ取得 を選択します。

      5. アプリケーションをインストールしたら、 に戻る CodeCatalyst を選択して に戻ります CodeCatalyst。

      Jira サイトを に接続したら CodeCatalyst、Jira Software 拡張機能の詳細ページの Connected Jira サイトタブで接続されたサイトを表示できます。

GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを使用するか、 で Jira の問題を管理するための 3 番目の最後のステップ CodeCatalyst は、それらを使用する CodeCatalyst プロジェクトにリンクすることです。

拡張の詳細ページから GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、または Jira プロジェクトを CodeCatalyst プロジェクトにリンクするには

  • インストールしたサードパーティーの拡張機能と接続したプロバイダーに応じて、次のいずれかを実行します。

    • GitHub リポジトリ : GitHub リポジトリをリンクします。

      1. リンクされた GitHub リポジトリタブで、リンク GitHub リポジトリ を選択します。

      2. GitHub アカウントドロップダウンから、リンクするリポジトリを含む GitHub アカウントを選択します。

      3. GitHub リポジトリドロップダウンから、 CodeCatalyst プロジェクトにリンクするリポジトリを選択します。

        ヒント

        リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。

      4. （オプション) GitHub リポジトリのリストにリポジトリが表示されない場合は、 の Amazon CodeCatalyst アプリケーションでリポジトリアクセスが設定されていない可能性があります GitHub。接続されたアカウント CodeCatalyst でどの GitHub リポジトリを使用できるかを設定できます。

        1. GitHub アカウントに移動し、設定 を選択し、アプリケーション を選択します。

        2. Installed GitHub Apps タブで、Amazon CodeCatalyst アプリケーションの設定を選択します。

        3. でリンクする GitHub リポジトリへのアクセスを設定するには、次のいずれかを実行します CodeCatalyst。

          • 現在および将来のすべてのリポジトリへのアクセスを提供するには、すべてのリポジトリ を選択します。

          • 特定のリポジトリへのアクセスを許可するには、「リポジトリの選択のみ」を選択し、「リポジトリの選択」ドロップダウンを選択し、「」でリンクを許可するリポジトリを選択します CodeCatalyst。

      5. CodeCatalyst プロジェクトドロップダウンメニューから、 GitHub リポジトリをリンクする CodeCatalyst プロジェクトを選択します。

      6. [Link (リンク)] を選択します。

      で GitHub リポジトリを使用しない場合は CodeCatalyst、プロジェクトからリポジトリの CodeCatalyst リンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、そのリポジトリを CodeCatalyst 開発環境で使用することはできません。詳細については、「での GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除 CodeCatalyst」を参照してください。

    • Bitbucket リポジトリ : Bitbucket リポジトリをリンクします。

      1. Linked Bitbucket リポジトリタブで、Link Bitbucket リポジトリ を選択します。

      2. Bitbucket ワークスペースドロップダウンから、リンクするリポジトリを含む Bitbucket ワークスペースを選択します。

      3. Bitbucket リポジトリドロップダウンから、 CodeCatalyst プロジェクトにリンクするリポジトリを選択します。

        ヒント

        リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。

      4. CodeCatalyst プロジェクトドロップダウンメニューから、Bitbucket リポジトリをリンクする CodeCatalyst プロジェクトを選択します。

      5. [Link (リンク)] を選択します。

      で Bitbucket リポジトリを使用しない場合は CodeCatalyst、プロジェクトから CodeCatalyst リンクを解除できます。リポジトリのリンクが解除されると、そのリポジトリ内のイベントはワークフローの実行を開始せず、そのリポジトリを CodeCatalyst 開発環境で使用することはできません。詳細については、「での GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除 CodeCatalyst」を参照してください。

    • GitLab リポジトリ : GitLab プロジェクトリポジトリをリンクします。

      1. Linked GitLab project repositories タブで、Link GitLab project repository を選択します。

      2. GitLab ユーザードロップダウンから、リンクするリポジトリを含む GitLab ユーザーを選択します。

      3. GitLab プロジェクトリポジトリドロップダウンから、 CodeCatalyst プロジェクトにリンクするリポジトリを選択します。

        ヒント

        リポジトリの名前がグレーアウトされている場合、そのリポジトリはスペース内の別のプロジェクトに既にリンクされているため、リンクできません。

      4. CodeCatalyst プロジェクトドロップダウンメニューから、 CodeCatalyst プロジェクトリポジトリをリンクする GitLab プロジェクトを選択します。

      5. [Link (リンク)] を選択します。

      で GitLab プロジェクトリポジトリを使用しない場合は CodeCatalyst、プロジェクトから CodeCatalyst リンクを解除できます。プロジェクトリポジトリのリンクが解除されると、そのプロジェクトリポジトリ内のイベントはワークフローの実行を開始せず、そのプロジェクトリポジトリを CodeCatalyst 開発環境とともに使用することはできません。詳細については、「での GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除 CodeCatalyst」を参照してください。

    • Jira Software : Jira プロジェクトをリンクします。

      1. Linked Jira プロジェクトタブで、Link Jira プロジェクト を選択します。

      2. Jira サイトのドロップダウンメニューから、リンクするプロジェクトを含む Jira サイトを選択します。

      3. Jira プロジェクトドロップダウンメニューから、プロジェクトにリンクする CodeCatalyst プロジェクトを選択します。

      4. CodeCatalyst プロジェクトドロップダウンメニューから、Jira CodeCatalyst プロジェクトにリンクするプロジェクトを選択します。

      5. [Link (リンク)] を選択します。

      Jira プロジェクトが CodeCatalyst プロジェクトにリンクされると、 CodeCatalyst 問題へのアクセスは完全に無効になり、 CodeCatalyst ナビゲーションペインの問題は Jira プロジェクトにリンクする Jira の問題項目に置き換えられます。

      CodeCatalyst 問題は、ナビゲーションペインでリンクされた Jira 問題に置き換えられました。

      で Jira プロジェクトを使用しない場合は CodeCatalyst、プロジェクトからリンクを解除できます CodeCatalyst。Jira プロジェクトがリンク解除されると、Jira の問題はプロジェクトで CodeCatalyst利用できなくなり、 CodeCatalyst 問題は再び問題プロバイダーになります。詳細については、「での GitHub リポジトリ、Bitbucket リポジトリ、 GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク解除 CodeCatalyst」を参照してください。

GitHub リポジトリ、Bitbucket リポジトリ、または GitLab プロジェクトリポジトリを、コード のソースリポジトリからプロジェクトにリンクすることもできます。詳細については、「接続されたサードパーティープロバイダーからのリソースのリンク」を参照してください。

次のステップ

GitHub リポジトリ 、Bitbucket リポジトリ 、またはGitLab リポジトリ拡張機能をインストールし、リソースプロバイダーを接続し、サードパーティーリポジトリを CodeCatalyst プロジェクトにリンクした後、 CodeCatalyst ワークフローと開発環境で使用できます。接続された GitHub アカウント、Bitbucket ワークスペース、またはブループリントから生成されたコードを持つ GitLab ユーザーでサードパーティーリポジトリを作成することもできます。詳細については、「サードパーティーリポジトリイベント後にワークフローを自動的に開始する」および「開発環境の作成」を参照してください。

Jira Software 拡張機能をインストールし、Jira サイトを接続し、Jira プロジェクトを CodeCatalyst プロジェクトにリンクし、プルリクエストをリンクすると、 の更新 CodeCatalyst が Jira プロジェクトに反映されます。プルリクエストを Jira の問題にリンクする詳細については、「」を参照してくださいJira の問題を CodeCatalyst プルリクエストにリンクする。Jira での CodeCatalyst イベントの表示の詳細については、「」を参照してくださいJira の問題での CodeCatalyst イベントの表示。