ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Bitbucket リポジトリの設定

Liferay Cloud のオンボーディングメールには、 dxpcloud 組織でホストされている GitHub リポジトリへのリンクが含まれています。このリポジトリは、チームのプライベート Liferay Cloud 開発リポジトリのテンプレートであり、通常は 10 営業日後に削除されます。ユーザーは

プロビジョニングされたリポジトリを独自のプライベートリポジトリに転送します。
Webhook を使用して、プライベートリポジトリを Liferay Cloud の Jenkins (CI) サービスと統合します。

プロビジョニングされたリポジトリは GitHub 上にありますが、Jenkins サービスのバージョン 3.2.0 以降では BitBucket リポジトリに転送できます。これは、BitBucket リポジトリへの管理者アクセス権を使用して実行する必要があります。

注

リポジトリの管理者 は、必ずしも Cloud コンソールのプロジェクト管理者 と同じではありません。

Jenkinsサービスの準備

Jenkinsfile をカスタマイズした場合は、このガイドに従ってデフォルトの Jenkinsfile を拡張してください。

Bitbucketリポジトリの作成

まず、新しいBitbucketリポジトリを作成します。

Bitbucketに移動します。
サイドバーの検索アイコンの下にある「＋」アイコンをクリックします。
［リポジトリ］ をクリックして、新しいリポジトリの作成を開始します。
リポジトリの名前を指定します。
アクセスレベルがプライベートに設定されていることを確認します。
設定 README を含めますか? いいえに。
リポジトリの作成をクリックします。

GitHubからBitbucketへの転送

以下の手順に従って、プロビジョニング済みの GitHub リポジトリを自分の Bitbucket リポジトリに転送します：

プロビジョニング済みのGitHubリポジトリをローカルでクローンします：
```
git clone git@github.com:dxpcloud/example.git
```
注

すでに他のプロバイダで作業するためにリポジトリをクローンしている場合は、このステップをスキップして、同じクローン内で作業することができます。
新しいGitリモートを追加し、Bitbucketをポイントします：
```
git remote add bitbucket git@bitbucket.org:example/example.git
```
クローンされたリポジトリを新しいリモートリポジトリにプッシュします：
```
git push bitbucket master
```

リポジトリの作成、クローン作成、プッシュに関するヘルプが必要な場合は、 Bitbucket のドキュメントを参照してください。

BitBucketのアプリパスワードの生成

次に、WebhookがBitbucketで認証してJenkinsビルドをトリガーするために使用するアプリパスワードを作成します。アプリのパスワードを生成するBitbucketユーザーは、リポジトリへの管理者レベルのアクセス権を持っている必要があります。

次の手順を実行して、アプリのパスワードを生成します：

ユーザー設定ページから、 ［Access Management］にある［App passwords］をクリックします。
アプリパスワードの作成をクリックします。
アプリパスワードのラベルを提供します。
アプリに次の権限を付与します：
- Pull request - read, write （これにより、リポジトリにもフラグが付けられます - 読み取り、書き込み）
- Webhooks - read, write
作成をクリックします。
アプリのパスワードをコピーします（再度表示されることはありません）。これはBitBucketの個人用アクセストークンに相当します。

重要

アプリパスワードを生成したユーザーは、 LCP_CI_SCM_USERNAME 環境変数に自分のユーザー名を使用する必要があります。

ブランチタイプと敬称の確認

Liferay Cloud がブランチに適切にリンクできるようにするには、リポジトリで使用されているブランチプレフィックスの完全なリストを提供する必要があります。リポジトリで使用されるブランチタイプには、それぞれ独自の敬称があり、リポジトリの設定で定義されています。

Bitbucket ウェブサイトで、左側のメニューから リポジトリ設定 → ブランチモデル をクリックします。これにより、 ブランチモデル ページに移動し、各ブランチのプレフィックスが表示されます。これらの各敬称をメモして、 LCP_CI_SCM_BITBUCKET_BRANCH_PREFIXES CI環境変数に追加してください。

Bitbucket リポジトリのデフォルトのブランチタイプ（および敬称）は、bugfix/、feature/、hotfix/、release/ です。

BitBucket を Jenkins サービスに接続する

最後に、新しいリポジトリを指すようにJenkinsサービスの環境変数を設定します：

Liferay Cloud Console にログインし、 インフラ 環境の Jenkins サービスに移動します。
［環境変数］ タブに移動します。
以下の環境変数を設定します：

名前	値
`LCP_CI_SCM_PROVIDER`	bitbucket
`LCP_CI_SCM_REPOSITORY_OWNER`	[repo owner]
`LCP_CI_SCM_REPOSITORY_NAME`	[repo name]
`LCP_CI_SCM_TOKEN`	[app password]
`LCP_CI_SCM_USERNAME`	[auth username]
`LCP_CI_SCM_BITBUCKET_BRANCH_PREFIXES`	[list of prefixes]

重要

セキュリティを強化するために、 LCP_CI_SCM_TOKEN の値を秘密変数に保存します。

LCP_CI_SCM_USERNAME を、アプリパスワードを生成したユーザーとして定義します。 LCP_CI_SCM_BITBUCKET_BRANCH_PREFIXES を、リポジトリのブランチで使用されるすべてのプレフィックスのリストとして定義し、スペースで区切ります。

これらの環境変数を更新した後、Jenkinsサービスは再起動します。これで、新しいリポジトリでプッシュされたブランチとプルリクエストがトリガーされます。

プライベートBitbucketサーバーへの接続

プライベートなBitbucketサーバーを使用するには、Jenkinsサービスで追加の環境変数を設定する必要があります：

名前	値
`LCP_CI_SCM_SERVER_HOST`	[private host URL]

LCP_CI_SCM_SERVER_HOST 変数に、プライベートBitbucketサーバーのベースURLを設定します（例えば、 http://private.bitbucket.org/）。これにより、ビルドを生成してリポジトリのブランチにリンクするときにCIがコードベースを取得するために使用するサーバーURLが設定されます。デフォルトでは、CIはBitbucketのベースURLとして https://bitbucket.org/ を使用しています。

ビルドの確認

プッシュされたブランチとプルリクエストは、Liferay Cloud Console の [ビルド] タブから表示またはデプロイできるビルドをトリガーします。 Jenkins サービスとの統合を設定したら、次のステップとして、インテグレーションが成功したかどうかを確認するためにビルドを検証します。

プッシュされたブランチからのビルドの確認

新しいGitプッシュがJenkinsビルドをトリガーすることを確認します：

リポジトリに変更を加え（ファイルの追加など）、ブランチにコミットします：
```
git commit -m "Add file to test builds"
```
ブランチをBitBucketにプッシュします：
```
git push bitbucket branch-name
```
Liferay Cloud Console の ビルド ページに移動します。
Builds ページで、プッシュされたブランチのビルドが表示されることを確認します。