GitLabリポジトリの設定¶
DXP Cloudオンボーディングメールを受信すると、 dxpcloud 組織でホストされているGitHubリポジトリがプロビジョニングされます。 このリポジトリは、チームの個別のプライベートDXP Cloud開発リポジトリのテンプレートとして使用する必要があり、通常は10営業日後に削除されます。 ユーザーは次のことを期待されています。
最初にプロビジョニングされたリポジトリを独自のプライベートリポジトリに転送します。
Webhookを使用して、そのリポジトリをDXP CloudのJenkins（CI）サービスと統合します。
プロビジョニングされたリポジトリはGitHubにありますが、Jenkinsサービスのバージョン3.2.0以降ではGitLabリポジトリに転送できます。
Jenkinsサービスの準備¶
開始する前に、 LCP.json で ci サービスを確認し、次のJenkinsサービス以上を実行していることを確認してください。
liferaycloud/jenkins:2.222.1-3.2.0
そうでない場合は、次の手順に従ってアップグレードします。
最後に、新しいリポジトリを指すようにJenkinsサービスの環境変数を設定します。
ルートフォルダーにある
Jenkinsfileを削除します。以下の環境変数を追加します。
LCP_CI_USE_DEFAULT_JENKINSFILE: true.Jenkinsサービスをデプロイします。
注釈
Jenkinsfile をカスタマイズしている場合は、以下のガイドに従って デフォルトの Jenkinsfile.
GitLabリポジトリの作成¶
まず、新しいGitLabリポジトリを作成します。
GitLabに移動します。
新しいプロジェクトをクリックします。
![[新しいプロジェクト]をクリックして、新しいGitLabリポジトリの作成を開始します。](../_images/017.png)
プロジェクトのスラッグ（URL内のリポジトリ名）を提供します。
表示レベルをプライベートに設定します（無料ユーザーは無制限のプライベートリポジトリを使用できます）。
READMEでリポジトリを初期化 がチェックされていないことを確認します。
プロジェクトを作成をクリックします。
GitHubからGitLabへの転送¶
以下の手順に従って、初期の GitHub リポジトリを自分の GitLab リポジトリに転送します。
最初のGitHubリポジトリをローカルでクローンします。
git clone git@github.com:dxpcloud/example.git注釈
すでに他のプロバイダで作業するためにリポジトリをクローンしている場合は、このステップをスキップして、同じクローン内で作業することができます。
新しいGitリモートを追加し、GitLabをポイントします。
git remote add gitlab git@gitlab.com:USERNAME/REPOSITORYNAME.gitクローンされたリポジトリを新しいリモートリポジトリにプッシュします。
git push gitlab master
GitHub リポジトリの作成、クローン、プッシュについてのヘルプが必要な場合は、 GitHub のドキュメントを参照してください。
GitLabのアクセストークンの生成¶
次に、JenkinsのビルドをトリガーするためにWebhookで使用するアクセストークンを作成します。
パーソナル・アクセストークンのページに移動します。
このアクセストークンの名前と有効期限を指定します。
次のアクセス許可を持つようにアクセストークンを設定します。
api
read_repository
write_repository
[ 個人用アクセストークンの作成]をクリックします。
アクセストークンをコピーしてどこかに保存します（それ以外の場合は表示されません）。
GitLabをJenkinsサービスに接続する¶
次の手順に従って、初期GitHubリポジトリを独自のGitLabリポジトリに転送します。
DXP Cloudコンソールにログインし、
インフラ環境でJenkinsサービスに移動します。「 環境変数 」タブに移動します。
以下の環境変数を設定します。
| 名前 | 値 |
|---|---|
LCP_CI_SCM_PROVIDER |
gitlab |
LCP_CI_SCM_REPOSITORY_OWNER |
[repo_owner] |
LCP_CI_SCM_REPOSITORY_NAME |
\ [リポジトリ\ _name ] |
LCP_CI_SCM_TOKEN |
[アクセストークン] |
これらの環境変数を更新すると、Jenkinsサービスが再起動します。 これで、新しいリポジトリ内のプッシュされたブランチとプルリクエストがトリガーされます。
追加のGitLab Webhook設定¶
次に、WebhookがJenkinsビルドをトリガーするために使用するアクセストークンを作成します。
GitLabリポジトリに移動します。
設定 、 Webhookを選択します。
Project Hooksで、作成されたWebhookがリストされていることを確認します。
CI Webhookの[ Edit ]ボタンをクリックします。
タグプッシュイベント と コメントのチェックを外します。
SSL検証を有効にするにチェックします。
[変更を保存] をクリックします。
ビルドの確認¶
プッシュされたブランチとマージリクエスト（GitLabのプルリクエストに相当）は、DXP Cloudコンソールの[ Builds ]タブから表示またはデプロイできるビルドをトリガーする必要があります。 Jenkins サービスとの統合を設定したら、次のステップとして、統合が成功したかどうかを確認するためにビルドを検証します。
プッシュされたブランチからのビルドの確認¶
新しいGitプッシュがJenkinsビルドをトリガーしていることを確認するには：
リポジトリに変更を加え（ファイルの追加など）、ブランチにコミットします。
git commit -m "Add file to test builds"ブランチをGitLabにプッシュします。
git push gitlab branch-name
DXP Cloudコンソールの ビルド ページに移動します。
ビルド ページで、プッシュされたブランチのビルドが表示されることを確認します。
マージリクエストからのビルドの確認¶
新しいマージ要求がJenkinsビルドをトリガーしていることを確認するには：
任意のブランチから
developブランチへのマージリクエストを作成します。マージ要求に対して新しいビルドが作成されていることを確認します。
DXP Cloudコンソールの ビルド ページに移動します。
ブランチのリンクをクリックして、適切なビルドでコミットします。
![[ビルド]ページで、ブランチのリンクを確認し、ビルドをコミットします。](../_images/053.png)
リンクが正しいGitLabページにリダイレクトすることを確認します。