Azureリポジトリの構成
Liferay Cloud のオンボーディング メールには、 dxpcloud 組織でホストされている GitHub リポジトリへのリンクが含まれています。 このリポジトリは、チームのプライベートなLiferay Cloud開発リポジトリのテンプレートであり、通常は10営業日後に削除されます。 ユーザーは、プロビジョニングされたリポジトリを自身のプライベートリポジトリに移行する必要があります。
Jenkinsサービスのバージョン3.2.0以降では、プロビジョニングされたGitHubリポジトリをAzureリポジトリに移行できます。 これは、Azureリポジトリへの管理者権限で実行する必要があります。
リポジトリの管理者 は、クラウド コンソールのプロジェクトの管理者 と必ずしも同じではありません。
Azureリポジトリの制限事項
Azureリポジトリを構成する前に、以下の制限事項にご注意ください。
- Azure DevOpsのプルリクエストはLiferay Cloudと統合されていません。
- Liferay Cloudは、Webhookを使用する代わりに、5分ごとにAzureリポジトリをポーリングして更新情報を取得します。 ブランチまたはタグへの変更が検出されると、ビルドがトリガーされます。
- 個人アクセストークン（PAT）は特定のユーザーアカウントに紐づけられ、一定期間後に有効期限が切れます。 トークンの有効期限が切れた場合、または関連付けられたアカウントが無効化された場合、統合によるビルドのトリガーは停止します。 チームメンバーが退職した際に業務が中断されるのを避けるため、個人アカウントではなく、サービスアカウントまたは組織アカウントを使用してください。
Jenkinsサービスの準備
Jenkinsfileをカスタマイズしている場合は、このガイドに従ってデフォルトのJenkinsfileを拡張してください。
GitHubからAzureへのインポート
-
Azure DevOps に移動してください。
-
新しいプロジェクト をクリックします。
-
プロジェクト名を指定してください。
-
表示設定が非公開になっていることを確認してください。
-
サイドナビゲーションの Repos をクリックします。
-
リポジトリをインポート の下にある インポート をクリックします。
-
GitHubリポジトリのURLを クローンURLに挿入します。
-
認証が必要 を選択してください。
-
ユーザー名とパスワード/PATのフィールドに入力し、 インポートをクリックします。
-
ターミナルで、プロビジョニングされたGitHubリポジトリをローカルにクローンします。
git clone git@github.com:dxpcloud/example.git注既に別のプロバイダで使用するためにリポジトリをクローンしている場合は、この手順をスキップして、同じクローン内で作業できます。
-
新しいGitリモートを追加し、Azureを指定します。
git remote add azure ORGANIZATION@dev.azure.com:ORGANIZATION/PROJECTNAME/_git/PROJECTNAME -
クローンされたリポジトリを新しいリモートリポジトリにプッシュします：
git push azure master
リポジトリの作成、クローン作成、プッシュについてサポートが必要な場合は、Azureのドキュメントを参照してください。
Azure のアクセス トークンを生成する
次に、Jenkinsビルドをトリガーするために使用するアクセストークンを作成します。
-
個人アクセストークンページに移動してください。
-
新しいトークン をクリックします。
-
このトークンの名前と有効期限を指定してください。
-
アクセストークンに以下の権限を付与するように設定してください。
- コード: 読み取り
AzureをJenkinsサービスに接続する
最後に、新しいリポジトリを指すようにJenkinsサービスの環境変数を設定します：
-
Liferay Cloud Consoleにログインし、
インフラ環境にあるJenkinsサービスに移動します。 -
［環境変数］ タブに移動します。
-
以下の環境変数を設定します：
| 名前 | 値 |
|---|---|
LCP_CI_SCM_PROVIDER | Azure DevOps |
LCP_CI_SCM_REPOSITORY_OWNER | [repo owner] |
LCP_CI_SCM_REPOSITORY_NAME | [repo name] |
LCP_CI_SCM_TOKEN | [アクセストークン] |
セキュリティを強化するため、 LCP_CI_SCM_TOKEN の値を 秘密変数 に保存します。
これらの環境変数を更新した後、Jenkinsサービスは再起動します。 Jenkinsは5分ごとにリポジトリをチェックし、プッシュされたブランチに対してビルドをトリガーします。
ビルドの確認
プッシュされたブランチはビルドをトリガーし、そのビルドはLiferay Cloud Consoleの「ビルド」タブから確認またはデプロイできます。 Jenkins サービスとの統合を設定したら、次のステップとして、インテグレーションが成功したかどうかを確認するためにビルドを検証します。 新しいGitプッシュがJenkinsビルドをトリガーすることを確認します：
-
リポジトリに変更を加え（ファイルの追加など）、ブランチにコミットします：
git commit -m "Add file to test builds" -
ブランチをAzure DevOpsにプッシュする：
git push azure branch-name -
Liferay Cloud Console の ビルド ページに移動します。
-
Builds ページで、プッシュされたブランチのビルドが表示されることを確認します。 これには最大5分かかる場合があります。