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

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

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

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

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

    重要

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

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

    重要

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

    重要

    リポジトリ拡張をインストールすると、リンク先のリポジトリのコード 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 ソフトウェアを使用すると、 で 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 ソフトウェア を検索できます。カテゴリに基づいて拡張をフィルタリングすることもできます。

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

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

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

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

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

GitHub アカウント、Bitbucket ワークスペース、または Jira サイトを に接続するには CodeCatalyst
  • インストールしたサードパーティーの拡張機能に応じて、次のいずれかを実行します。

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

      1. 「接続された GitHub アカウント」タブで GitHub 「アカウントの接続」を選択して、 の外部サイトに移動します 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 workspaces」タブで「Connect Bitbucket workspace」を選択して、Bitbucket の外部サイトに移動します。

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

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

        ヒント

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

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

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

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

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

        ヒント

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

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

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

    • Jira ソフトウェア: Jira サイトを接続します。

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

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

        注記

        以前に Jira サイト CodeCatalyst にインストールしたことがある場合は、通知が送信されます。「開始」を選択して、最後のステップに進みます。

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

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

          注記

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

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

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

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

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

      Jira サイトを に接続したら CodeCatalyst、Jira ソフトウェア拡張の詳細ページの Connected Jira sites タブで接続されたサイトを表示できます。

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. リンクされた GitLab プロジェクトリポジトリ タブで、 GitLab プロジェクトリポジトリのリンク を選択します。

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

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

        ヒント

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

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

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

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

    • Jira ソフトウェア: Jira プロジェクトをリンクします。

      1. Linked Jira projects タブで、Link Jira project を選択します。

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

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

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

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

      Jira プロジェクトが CodeCatalyst プロジェクトにリンクされると、 CodeCatalyst 問題へのアクセスは完全に無効になり、 CodeCatalyst ナビゲーションペインの問題Jira プロジェクトにリンクする 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 ソフトウェア拡張機能をインストールし、Jira サイトを接続し、Jira プロジェクトを CodeCatalyst プロジェクトにリンクし、プルリクエストをリンクすると、 からの更新 CodeCatalyst が Jira プロジェクトに反映されます。プルリクエストを Jira の問題にリンクする方法の詳細については、「」を参照してくださいJira の問題の CodeCatalyst プルリクエストへのリンク。Jira での CodeCatalyst イベントの表示の詳細については、「」を参照してくださいJira の問題での CodeCatalyst イベントの表示