Cloud Manager でのプライベートリポジトリの追加 private-repositories

独自のプライベート GitHub リポジトリを操作すると、Cloud Manager を通じて GitHub リポジトリ内でコードを直接検証できるので、コードを Adobe リポジトリと一貫して同期する必要がなくなります。

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

設定 configuration

設定は、次の 2 つの主な手順で構成されます。

リポジトリを追加 add-repo

  1. Cloud Manager の​ プログラムの概要 ​ページで、「リポジトリ」タブを選択して​ リポジトリ ​ページに切り替え、「リポジトリを追加」をクリックします。

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

  3. リポジトリの詳細を指定します

    • リポジトリ名 - 表現名
    • リポジトリ URL - リポジトリの URL。.git で終了する必要があります。
    • 説明(オプション)- 必要に応じてリポジトリの詳細な説明

    独自のリポジトリの追加

  4. 保存」を選択します。

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

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

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

  1. 独自のリポジトリを追加すると、プライベートリポジトリの所有権の検証 ​ダイアログが開きます。

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

  2. Cloud Manager は、GitHub アプリを使用して、リポジトリと安全にやり取りします。

    • GitHub 組織の所有者は、https://github.com/apps/cloud-manager-for-aem にあるアプリをインストールし、リポジトリへのアクセス権を付与する必要があります。
    • これを行う方法について詳しくは、GitHub のドキュメントを参照してください。
  3. セキュリティを強化するには、リポジトリのデフォルトのブランチに秘密鍵ファイルを作成する必要があります。「生成」を選択します。

  4. 確認」をタップまたはクリックして、秘密鍵ファイルの生成を確認します。

    秘密鍵の生成の確認

  5. プライベートリポジトリの所有権の検証 ​ウィンドウに戻ると、Cloud Manager は「秘密鍵ファイルコンテンツ」フィールドにプライベートファイルのコンテンツを生成しています。そのフィールドからコンテンツをコピーします。

    • 秘密鍵ファイルのコンテンツは 1 回だけ表示されます。このウィンドウを閉じる前にコンテンツをコピーしない場合は、秘密鍵を再生成します。

    秘密鍵ファイルコンテンツのコピー

  6. GitHub リポジトリのデフォルトブランチに .well-known/adobe/cloud-manager-challenge という名前の新しいファイルを作成し、秘密鍵ファイルコンテンツをそのファイルにペーストして保存します。

  7. アプリがインストールされ、秘密鍵ファイルがリポジトリに存在すると、プライベートリポジトリの所有権の検証 ​ダイアログで「検証」を選択できます。

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

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

未検証のリポジトリ

タイプ ​列では、アドビ提供のリポジトリ(Adobe)と独自の GitHub リポジトリ(GitHub)を簡単に識別できます。

検証を完了するために後日リポジトリに戻る必要がある場合は、リポジトリ ​ページで、追加したばかりの GitHub リポジトリを表す行の省略記号ボタンを選択し、ドロップダウンメニューから「所有権の検証」を選択します。

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

Cloud Manager で GitHub リポジトリを検証すると統合が完了し、Cloud Manager でリポジトリを使用できるようになります。

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

    GitHub チェック

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

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

    GitHub コード品質チェック

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

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

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

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

NOTE
Web 階層設定パイプラインは、プライベートリポジトリではサポートされていません。

制限事項 limitations

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

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