Cloud Manager でのプライベートリポジトリの追加 private-repositories
独自のプライベート GitHub リポジトリを操作する Cloud Manager を設定する方法について説明します。
概要 overview
Cloud Manager をプライベート GitHub リポジトリで設定すると、GitHub 内でコードを直接検証できるので、Adobe リポジトリと頻繁に同期する必要がなくなります。
設定 configuration
設定は、次の 2 つの主な手順で構成されます。
リポジトリの追加 add-repo
-
Cloud Manager の プログラムの概要 ページで、「リポジトリ」タブをクリックして リポジトリ ページに切り替え、「リポジトリを追加」をクリックします。
-
リポジトリを追加ダイアログボックスで、リポジトリタイプとして「プライベートリポジトリ」を選択します。
-
リポジトリの次の詳細を入力します。
- リポジトリ名 – わかりやすい名前。
- リポジトリ URL - リポジトリのURLで、
.gitで終わる必要があります。 - 説明 (オプション) – 必要に応じて、リポジトリの長い説明を指定します。
-
「保存」をクリックします。
プライベートリポジトリ所有権の検証 validate-ownership
Cloud ManagerはGitHub リポジトリで設定されていますが、アクセスするには認証が必要です。 アクセス権を付与するには、Adobe GitHub アプリをインストールし、指定したリポジトリを所有していることを確認する必要があります。
-
独自のリポジトリを追加すると、プライベートリポジトリの所有権の検証ダイアログボックスが表示されます。
-
Cloud Manager は、GitHub アプリを使用して、リポジトリと安全にやり取りします。
GitHub組織の所有者は、
https://github.com/apps/cloud-manager-for-aemにあるアプリをインストールし、リポジトリへのアクセスを提供する必要があります。 詳しくは、GitHub のドキュメントを参照してください。 -
セキュリティを強化するには、リポジトリのデフォルトのブランチに秘密鍵ファイルを作成します。 「生成」をクリックします。
-
「確認」をクリックして、秘密鍵ファイルの生成を確認します。
-
プライベートリポジトリの所有権の検証ダイアログボックスに戻ると、Cloud Manager は「秘密鍵ファイルコンテンツ」フィールドにコンテンツを生成しています。 そのフィールドからコンテンツをコピーします。
シークレットファイルの内容は1回だけ表示されます。 このウィンドウを閉じる前にコンテンツをコピーしない場合は、秘密鍵を再生成する必要があります。
-
GitHub リポジトリのデフォルトブランチ
.well-known/adobe/cloud-manager-challengeに新しいファイルを作成し、シークレットファイルの内容をそのファイルに貼り付けて保存します。 -
アプリがインストールされ、秘密鍵ファイルがリポジトリに存在すると、プライベートリポジトリの所有権の検証ダイアログで「検証」をクリックできます。
アプリのインストールと秘密鍵ファイルの生成は、任意の順序で行うことができます。 ただし、検証する前に両方の手順を完了する必要があります。
検証されるまで、リポジトリは赤色のアイコンで表示されます。これは、リポジトリがまだ検証されておらず、まだ使用できないことを示します。
タイプ列では、アドビ提供のリポジトリ(Adobe)と独自の GitHub リポジトリ(GitHub)を簡単に識別できます。
後でリポジトリに戻って検証を完了するには、リポジトリページに移動します。 追加したGitHub リポジトリの横にある
Cloud Manager でのプライベートリポジトリの使用 using
Cloud Manager で GitHub リポジトリを検証すると統合が完了し、Cloud Manager でリポジトリを使用できるようになります。
Cloud Manager でプライベートリポジトリを使用するには:
-
プルリクエストを作成すると、GitHub チェックが自動的に開始します。
-
プルリクエストごとに、フルスタックコード品質パイプラインが自動的に作成されます。 このパイプラインは、プルリクエストの更新のたびに開始されます。
-
コード品質チェックが完了するまで、GitHub チェックは実行状態のままです。 コード品質の結果は、GitHub チェックに生成されます。
プルリクエストが閉じられるか結合されると、作成したフルスタックコード品質パイプラインが自動的に削除されます。
プライベートリポジトリとパイプラインの関連付け pipelines
検証済みのプライベートリポジトリは、フルスタックパイプラインおよびフロントエンドパイプラインに関連付けることができます。
制限事項 limitations
Cloud Manager でプライベートリポジトリを使用する場合は、特定の制限が適用されます。
- 実稼動のフルスタックパイプラインでプライベートリポジトリを使用する場合、Git タグは作成およびプッシュされません。
- Adobe GitHub アプリがGitHub組織から削除された場合、このアクションにより、すべてのリポジトリのプルリクエスト検証機能が削除されます。
- プライベートリポジトリとオンコミットされたビルドトリガーを使用するパイプラインは、新しいコミットが選択したブランチにプッシュされたときに自動的に開始されません。
- アーティファクト再利用機能は、プライベートリポジトリには適用されません。
- Cloud Manager から GitHub チェックを使用して、プルリクエストの検証を一時停止できません。 GitHub リポジトリが Cloud Manager で検証されている場合、Cloud Manager は、そのリポジトリに対して作成されたプルリクエストの検証を試みます。
- GitHub 組織で IP 制限が適用されている場合は、サポートケースを開いて、許可する必要がある IP アドレスのリストを取得します。