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

Azure リポジトリの構成

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

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

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

Jenkinsサービスの準備

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

GitHub から Azure へのインポート

  1. Azure DevOpsに移動します。

  2. 新しいプロジェクトをクリックします。

    新しい Azure リポジトリの作成を開始するには、[新しいプロジェクト] をクリックします。

  3. プロジェクトの名前を入力します。

  4. 可視性が非公開に設定されていることを確認します。

  5. サイドナビゲーションで リポジトリ をクリックします。

  6. リポジトリをインポートの下の インポート をクリックします。

    「インポート」をクリックしてインポートモーダルを開きます。

  7. GitHubリポジトリのURLを クローンURLに挿入します。

  8. 認証が必要を選択します。

    インポート モーダルを使用して GitHub リポジトリをインポートします。

  9. ユーザー名とパスワード/PAT フィールドに入力し、 インポートをクリックします。

  10. ターミナルで、プロビジョニングされた GitHub リポジトリをローカルにクローンします。

    
    git clone git@github.com:dxpcloud/example.git
    
    

    別のプロバイダーで作業するためにリポジトリをすでにクローンしている場合は、この手順をスキップして、同じクローン内で作業できます。

  11. 新しい Git リモートを追加し、Azure をポイントします。

    
    git remote add azure ORGANIZATION@dev.azure.com:ORGANIZATION/PROJECTNAME/_git/PROJECTNAME
    
    
  12. クローンされたリポジトリを新しいリモートリポジトリにプッシュします:

    
    git push azure master
    
    

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

Azureのアクセストークンの生成

次に、Webhook が Jenkins ビルドをトリガーするために使用するアクセス トークンを作成します。

  1. 個人アクセス トークン ページに移動します。

    Azure の個人用アクセス トークンを作成します。このトークンには後で再度アクセスすることはできません。

  2. 新しいトークンをクリックします。

  3. このトークンの名前と有効期限を指定します。

  4. 以下の権限を持つようにアクセス トークンを構成します。

    • コード: 読み取り

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

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

  1. Liferay Cloud Console にログインし、 インフラ 環境の Jenkins サービスに移動します。

  2. [環境変数] タブに移動します。

  3. 以下の環境変数を設定します:

名前
LCP_CI_SCM_PROVIDERAzure DevOps
LCP_CI_SCM_REPOSITORY_OWNER[repo owner]
LCP_CI_SCM_REPOSITORY_NAME[repo name]
LCP_CI_SCM_TOKEN[アクセストークン]
重要

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

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

ビルドの確認

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

  1. リポジトリに変更を加え(ファイルの追加など)、ブランチにコミットします:

    git commit -m "Add file to test builds"
    
  2. ブランチを Azure DevOps にプッシュします。

    git push azure branch-name
    
  3. Liferay Cloud Console の ビルド ページに移動します。

  4. Builds ページで、プッシュされたブランチのビルドが表示されることを確認します。 これには最大 5 分ほどかかる場合があります。