Cloud Managerにプライベート GitHub リポジトリを追加する private-repositories
プライベート GitHub リポジトリと統合するように Cloud Manager をセットアップすると、Cloud Manager を使用して GitHub 内で直接コードを検証できます。この設定により、コードをAdobeリポジトリと定期的に同期する必要がなくなります。
設定 configuration
Cloud Manager でのプライベート GitHub リポジトリの設定は、次の 2 つの手順で構成されます。
- 選択したプログラムにプライベート GitHub リポジトリを追加します。
- 次に、プライベート GitHub リポジトリの所有権を検証します。
プログラムへのプライベート GitHub リポジトリの追加 add-repo
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織を選択します。
-
マイプログラム コンソールで、プライベート Git リポジトリをリンクするプログラムを選択します。
-
サイドメニューの「サービス」で、 、「リポジトリ」を選択します。
-
リポジトリ ページの右上隅付近にある「リポジトリを追加」をクリックします。
-
リポジトリを追加 ダイアログボックスで、リポジトリタイプとして「プライベートリポジトリ」を選択します。
-
各フィールドに、リポジトリに関する次の詳細を入力します。
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 パスは説明用です)。説明(オプション) リポジトリの詳細な説明です。 -
「保存」を選択します。
これで、 プライベートリポジトリの所有権を検証できます。
プライベート GitHub リポジトリの所有権の検証 validate-ownership
Cloud Manager は GitHub リポジトリを認識しましたが、引き続きアクセスする必要があります。アクセス権を付与するには、Adobe GitHub アプリをインストールし、指定したリポジトリを所有していることを確認する必要があります。
プライベート GitHub リポジトリの所有権を検証するには:
-
独自のリポジトリを追加した後、プライベートリポジトリ所有権の検証 ダイアログボックスで残りの手順に従います。
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 回だけ表示されます。このダイアログボックスを閉じる前にコンテンツをコピーしない場合は、秘密鍵を再生成します。 -
GitHub リポジトリのデフォルトブランチに、次の名前の新しいファイルを作成します。
.well-known/adobe/cloud-manager-challenge
-
秘密鍵ファイルのコンテンツを、先ほど作成した新しいファイルに貼り付けて保存します。
アプリがインストールされ、秘密鍵ファイルがリポジトリに存在する場合は、手順を続行します。
-
プライベートリポジトリ所有権の検証 ダイアログボックスで、「検証」をクリックします。
アプリのインストールと秘密鍵ファイルの作成は、任意の順序で行うことができます。ただし、検証する前に両方の手順を完了する必要があります。
検証されるまで、リポジトリは赤色のアイコンで表示されます。これは、リポジトリがまだ検証されておらず、まだ使用できないことを示します。
リポジトリ ページのテーブルの タイプ 列は、アドビ提供のリポジトリ(Adobe)と独自のプライベートリポジトリ(GitHub)を識別します。
後でリポジトリに戻って検証を完了する必要がある場合は、リポジトリ ページで、自身が追加した GitHub リポジトリを表す行の をクリックします。ドロップダウンリストで、「所有権の検証」を選択します。
Cloud Manager でのプライベート GitHub リポジトリの使用 using
Cloud Manager で GitHub リポジトリが検証されると、統合は完了です。Cloud Manager でリポジトリを使用できます。
Cloud Manager でプライベートリポジトリを使用するには:
-
プルリクエストを作成すると、GitHub チェックが自動的に開始します。
-
プルリクエストごとに、フルスタックコード品質パイプラインが自動的に作成されます。このパイプラインは、プルリクエストの更新のたびに開始されます。
-
GitHub チェックは、コード品質チェックが完了するまで実行状態のままになります。コード品質の結果は、GitHub チェックに生成されます。
プルリクエストが結合されるか閉じられると、作成したフルスタックコード品質パイプラインが自動的に削除されます。
プライベートリポジトリとパイプラインの関連付け pipelines
検証済みのプライベートリポジトリは、フルスタックパイプラインおよびフロントエンドパイプラインに関連付けることができます。
制限事項 limitations
Cloud Manager でプライベートリポジトリを使用する場合は、特定の制限が適用されます。
- Web 階層および設定パイプラインは、プライベートリポジトリではサポートされていません。
- 実稼動のフルスタックパイプラインでプライベートリポジトリを使用する場合、Git タグは作成およびプッシュされません。
- Adobe GitHub アプリを GitHub 組織から削除すると、すべてのリポジトリのプルリクエスト検証機能が削除されます。
- プライベートリポジトリとコミット時のビルドトリガーを使用するパイプラインは、選択したブランチに新しいコミットがプッシュされた場合に自動的に開始されません。
- アーティファクト再利用機能は、プライベートリポジトリには適用されません。
- Cloud Manager の GitHub チェックを使用して、プルリクエストの検証を一時停止することはできません。
GitHub リポジトリが Cloud Manager で検証される場合、Cloud Manager は常に、そのリポジトリに対して作成されたプルリクエストの検証を試みます。