Cloud Managerにプライベート GitHub リポジトリを追加する private-repositories

プライベート GitHub リポジトリと統合するように Cloud Manager をセットアップすると、Cloud Manager を使用して GitHub 内で直接コードを検証できます。この設定により、コードをAdobeリポジトリと定期的に同期する必要がなくなります。

NOTE
この機能は、パブリック GitHub 専用です。自己ホスト型 GitHub のサポートは利用できません。

設定 configuration

Cloud Manager でのプライベート GitHub リポジトリの設定は、次の 2 つの手順で構成されます。

プログラムへのプライベート GitHub リポジトリの追加 add-repo

  1. my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織を選択します。

  2. マイプログラム ​コンソールで、プライベート Git リポジトリをリンクするプログラムを選択します。

  3. サイドメニューの「サービス」で、 フォルダーアイコン 、「リポジトリ」を選択します。

    リポジトリページ

  4. リポジトリ ​ページの右上隅付近にある「リポジトリを追加」をクリックします。

  5. リポジトリを追加 ​ダイアログボックスで、リポジトリタイプとして「プライベートリポジトリ」を選択します。

    独自のリポジトリの追加

  6. 各フィールドに、リポジトリに関する次の詳細を入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2
    フィールド 説明
    リポジトリ名 新しいリポジトリのわかりやすい名前。
    リポジトリ URL プライベートリポジトリの URL(.git で終了する必要があります)。
    例:https://github.com/org-name/repo-name.git(URL パスは説明用です)。
    説明(オプション) リポジトリの詳細な説明です。
  7. 保存」を選択します。
    これで、 プライベートリポジトリの所有権を検証できます。

TIP
Cloud Manager でのリポジトリ管理について詳しくは、Cloud Manager リポジトリを参照してください。

プライベート GitHub リポジトリの所有権の検証 validate-ownership

Cloud Manager は GitHub リポジトリを認識しましたが、引き続きアクセスする必要があります。アクセス権を付与するには、Adobe GitHub アプリをインストールし、指定したリポジトリを所有していることを確認する必要があります。

プライベート GitHub リポジトリの所有権を検証するには:

  1. 独自のリポジトリを追加した後、プライベートリポジトリ所有権の検証 ​ダイアログボックスで残りの手順に従います。

    プライベートリポジトリの所有権の検証

    table 0-row-2 1-row-2 2-row-2
    説明
    手順 1:GitHub アプリ Cloud Manager は、GitHub アプリを使用して、プライベートリポジトリと安全にやり取りします。
    • GitHub 組織の所有者は、https://github.com/apps/cloud-manager-for-aem にあるアプリをインストールし、リポジトリへのアクセス権を付与する必要があります。
    • インストールとアクセス権の付与に関する詳細については、GitHub のドキュメントを参照してください。
    手順 2:秘密鍵ファイル セキュリティを強化するには、リポジトリのデフォルトのブランチに秘密鍵ファイルを作成する必要があります。
    • 「生成」をクリックし、「確認」をクリックします。Cloud Manager は、「秘密鍵ファイルコンテンツ」テキストフィールドに秘密鍵ファイルのコンテンツを生成します。
    コピーアイコン をクリックして、そのフィールドからコンテンツをコピーします。秘密鍵ファイルのコンテンツは 1 回だけ表示されます。このダイアログボックスを閉じる前にコンテンツをコピーしない場合は、秘密鍵を再生成します。
  2. GitHub リポジトリのデフォルトブランチに、次の名前の新しいファイルを作成します。

    .well-known/adobe/cloud-manager-challenge

  3. 秘密鍵ファイルのコンテンツを、先ほど作成した新しいファイルに貼り付けて保存します。

    アプリがインストールされ、秘密鍵ファイルがリポジトリに存在する場合は、手順を続行します。

  4. プライベートリポジトリ所有権の検証 ​ダイアログボックスで、「検証」をクリックします。

アプリのインストールと秘密鍵ファイルの作成は、任意の順序で行うことができます。ただし、検証する前に両方の手順を完了する必要があります。

検証されるまで、リポジトリは赤色のアイコンで表示されます。これは、リポジトリがまだ検証されておらず、まだ使用できないことを示します。

未検証のリポジトリ

リポジトリ ​ページのテーブルの​ タイプ ​列は、アドビ提供のリポジトリ(Adobe)と独自のプライベートリポジトリ(GitHub)を識別します。

後でリポジトリに戻って検証を完了する必要がある場合は、リポジトリ ​ページで、自身が追加した GitHub リポジトリを表す行の 詳細アイコン をクリックします。ドロップダウンリストで、「所有権の検証」を選択します。

Cloud Manager でのプライベート GitHub リポジトリの使用 using

Cloud Manager で GitHub リポジトリが検証されると、統合は完了です。Cloud Manager でリポジトリを使用できます。

Cloud Manager でプライベートリポジトリを使用するには:

  1. プルリクエストを作成すると、GitHub チェックが自動的に開始します。

    GitHub チェック

  2. プルリクエストごとに、フルスタックコード品質パイプラインが自動的に作成されます。このパイプラインは、プルリクエストの更新のたびに開始されます。

  3. GitHub チェックは、コード品質チェックが完了するまで実行状態のままになります。コード品質の結果は、GitHub チェックに生成されます。

    GitHub コード品質チェック

プルリクエストが結合されるか閉じられると、作成したフルスタックコード品質パイプラインが自動的に削除されます。

TIP
プルリクエストチェックの実行時に GitHub 経由で提供される情報について詳しくは、GitHub チェック注釈を参照してください。
TIP
プライベートリポジトリに対する各プルリクエストを検証するために自動的に作成されるパイプラインは、制御することができます。詳しくは、プライベートリポジトリに対する GitHub チェック設定を参照してください。

プライベートリポジトリとパイプラインの関連付け pipelines

検証済みのプライベートリポジトリは、フルスタックパイプラインおよびフロントエンドパイプラインに関連付けることができます。

制限事項 limitations

Cloud Manager でプライベートリポジトリを使用する場合は、特定の制限が適用されます。

  • Web 階層および設定パイプラインは、プライベートリポジトリではサポートされていません。
  • 実稼動のフルスタックパイプラインでプライベートリポジトリを使用する場合、Git タグは作成およびプッシュされません。
  • Adobe GitHub アプリを GitHub 組織から削除すると、すべてのリポジトリのプルリクエスト検証機能が削除されます。
  • プライベートリポジトリとコミット時のビルドトリガーを使用するパイプラインは、選択したブランチに新しいコミットがプッシュされた場合に自動的に開始されません。
  • アーティファクト再利用機能は、プライベートリポジトリには適用されません。
  • Cloud Manager の GitHub チェックを使用して、プルリクエストの検証を一時停止することはできません。
    GitHub リポジトリが Cloud Manager で検証される場合、Cloud Manager は常に、そのリポジトリに対して作成されたプルリクエストの検証を試みます。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab