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

github.comでホストされているプライベート GitHub リポジトリと統合するようにCloud Managerを設定すると、Cloud Managerを使用してGitHub内で直接コードを検証できます。 このページは、GitHub プラン (無料、Pro、チーム、またはエンタープライズ クラウド)に関係なく、github.comでホストされているすべてのリポジトリに適用されます。 この設定により、コードを Adobe リポジトリと定期的に同期する必要がなくなります。

IMPORTANT
Cloud Managerは、リポジトリのホスト場所に応じて、次の2つの方法のいずれかでGitHub リポジトリの所有権を検証します。
  • このページは、GitHub プラン (無料、Pro、チーム、またはエンタープライズ クラウド)に関係なく、github.comでホストされているすべてのリポジトリに適用されます。 これらのリポジトリでは、Adobe GitHub アプリを使用して所有権を検証します。 Cloud Managerはアプリを通じて直接統合されるため、Webhookの設定は必要ありません。

  • 次のいずれかのリポジトリタイプを追加する場合は、Cloud Managerでの外部リポジトリの追加を参照してください。 これらのリポジトリでは、PAT (個人アクセストークン)と手動で設定されたWebhookを使用して所有権を検証します。

    • GitHub Enterprise Server (GitHubのセルフホスティング版)リポジトリ。
    • GitLab (gitlab.comとGitLabのセルフホスティング版の両方)リポジトリ。
    • Bitbucket (のみbitbucket.org、クラウドバージョン) リポジトリ。 Bitbucketのセルフホスティング バージョンは、2024年2月15日(PT)をもって非推奨(廃止予定)となりました。
    • Azure DevOps (dev.azure.com) リポジトリ。

設定 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:秘密鍵ファイル セキュリティを強化するには、リポジトリのデフォルトブランチに秘密ファイルを作成する必要があります。
    ・「Generate」をクリックし、「確認」をクリックします。 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でプライベート GitHub リポジトリを使用するには:

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

    GitHub チェック

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

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

    GitHub コード品質チェック

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

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

プライベート GitHub リポジトリをパイプラインに関連付ける pipelines

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

制限事項 limitations

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

  • 実稼動のフルスタックパイプラインでプライベートリポジトリを使用する場合、Git タグは作成およびプッシュされません。
  • Adobe GitHub アプリがGitHub組織から削除された場合、すべてのリポジトリのプルリクエスト検証機能が削除されます。
  • プライベート GitHub リポジトリと「on-commit」ビルドトリガーを使用するパイプラインは、選択したブランチに新しいコミットがプッシュされたときに自動的に開始されません。
  • アーティファクト再利用機能は、プライベートリポジトリには適用されません。
  • Cloud Manager から GitHub チェックを使用して、プルリクエストの検証を一時停止できません。 GitHub リポジトリが Cloud Manager で検証される場合、Cloud Manager は常に、そのリポジトリに対して作成されたプルリクエストの検証を試みます。
  • GitHub 組織で IP 制限が適用されている場合は、サポートケースを開いて、許可する必要がある IP アドレスのリストを取得します。
recommendation-more-help
experience-manager-cloud-service-help-main-toc