1. 開発者向けのドキュメント

プロジェクトと環境をDeployする

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Timing 10分

これは 「はじめに攻略」シリーズのパート1です。このステップを終えたら、サイトとページの作成に進みましょう。

Deployアプリで新しい プロジェクト を作成すると、自動的に 環境 が作成され、初期デプロイが実行されます。このトピックでは、Deployアプリでプロジェクトを作成します。 Sitecore CLIDeploy APIを使ってプロジェクトを作成することもできます。

注記

作成できるプロジェクトの数は、SitecoreAIサブスクリプションに基づいています。

ここで説明されている手順は、Next.jsをContent SDKと組み合わせているのか、ASP.NET Core SDKを使うのかによって異なります。

このウォークスルーでは、以下の方法を説明します:

始める前に
  • Sitecore Cloud Portal組織に参加し、プロジェクトを立ち上げたい組織内でOrganization AdminまたはOrganization Ownerの役割を持つ必要があります。

  • Content SDKを使用している場合は、GitHubまたはAzureのDevOpsサービスアカウントとその認証情報を準備してください。

  • ASP.Net Core SDKを使っている場合は、GitHubでASP.Netスターターリポジトリを開き、ログインしてUse this template > Create a new repositoryをクリックし、スターターキットを基に自分専用リポジトリを作成する手順に従ってください。

Open the Deployアプリを開いてください

Deployアプリで最初のプロジェクトを作成し始め、https://deploy.sitecorecloud.io/に直接アクセスできます。

Cloud PortalでDeployアプリを開くには:

複数の組織に所属している場合は、希望する組織に切り替える必要があるかもしれません。

Deploy a project(プロジェクトをデプロイする)

Deployアプリで新しい プロジェクト を作成すると、自動的に 環境 が作成され、そこで初期デプロイが実行されます。

注記

Decoupled Deploymentsベータ機能を有効にしている場合は、ベー タ機能が有効になったときにプロジェクトをデプロイするために、以下の指示に従ってください。

Content SDK (Next.js)

Content SDKアプリを作成する場合、このウォークスルーでは、Deployアプリの既製フローでContent SDKスター ターキット を使ってプロジェクトを作成します。

DeployアプリでContent SDKプロジェクトをデプロイするには:

  1. DeployアプリのProjectsページでCreate projectをクリックします。

    The Create project button in the Deploy app
  2. 例えば、プロジェクト名を「 Getting Started」とし、Continueをクリックします。

  3. プロジェクトで使用するソース管理プロバイダーを選ぶには、Connectをクリックし、Continue。Deployアプリは環境コードを保存するための新しいリポジトリを作成します。

  4. Set up repositoryステップで、Use XM Cloud templateが選択されていることを確認してください。

    XM Cloudは現在SitecoreAIとなっています

    一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

  5. 既存の接続がなければ、Connect to a new accountをクリックし、アカウント内でDeployアプリの認証手順に従ってください。後で ソース管理プロバイダーの接続管理も可能です。

  6. リポジトリの名前を入力して、例えばGetting-StartedContinueをクリックします。

    注記

    リポジトリ名は英数字、アンダースコア、ピリオド、ハイフンのみ、最大100文字までしか含めません。また、ソース管理プロバイダーのリポジトリ命名規則に従う必要があります。

  7. 例えば、環境の名前を挙げてみて、Getting Started

  8. Production SaaS SLA欄でNoを選択します。

    大事な

    本番環境は本番トラフィックに最適化されており、Sitecore SaaSサービスレベルアグリーメントによってカバーされています。この設定は後で変更できません。

  9. Auto deploy on push to repository欄でYesを選択します。

  10. 設定を確認してStart deploymentをクリックします。

  11. 展開は数分間実行され、進捗を確認するために展開ログ画面にリダイレクトされます(数秒かかることもあります)。完成後はSitecoreAIに行って新しいサイトを作成できます。デプロイは接続されたソース管理アカウントに新しいリポジトリを作成し、Foundationテンプレートから新しいリポジトリにソースコードをコピーします。

ASP.NETコアSDK

ASP.NET Coreアプリを作成する場合、このウォークスルーでは.NET Coreスターターキット を使ってDeployアプリの「Bring your-own」コードフローでプロジェクトを作成します。

Deployアプリで.NET Coreプロジェクトをデプロイするには:

  1. DeployアプリのProjectsページでCreate projectをクリックします。

    The Create project button in the Deploy app
    XM Cloudは現在SitecoreAIとなっています

    一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

  2. 例えば、プロジェクト名を「 Getting Started」とし、Continueをクリックします。

  3. プロジェクトで使用するソース管理プロバイダーを選ぶには、Connectをクリックし、Continue。Deployアプリは環境コードを保存するための新しいリポジトリを作成します。

  4. Set up repositoryウィンドウでUse your own codeをクリックします。

  5. 既存の接続がなければ、Connect to a new accountをクリックし、アカウント内でDeployアプリの認証手順に従ってください。後で ソース管理プロバイダーの接続管理も可能です。

  6. .Net CoreスターターキットをクローンしたGitHubアカウントとリポジトリを選択し(デフォルトのブランチは自動選択されているはずです)、Continueをクリックします。

    注記

    リポジトリ名は英数字、アンダースコア、ピリオド、ハイフンのみ、最大100文字までしか含めません。また、ソース管理プロバイダーのリポジトリ命名規則に従う必要があります。

  7. オーサリング環境の名前はGetting Started

  8. Production SaaS SLA欄でNoを選択します。

    大事な

    本番環境は本番トラフィックに最適化されており、Sitecore SaaSサービスレベルアグリーメントによってカバーされています。この設定は後で変更できません。

  9. Auto deploy on push to repository欄でYesを選択します。

  10. 設定を確認してStart deploymentをクリックします。

  11. 展開は数分間実行され、進捗を確認するために展開ログ画面にリダイレクトされます(数秒かかることもあります)。完成後はSitecoreAIに行って新しいサイトを作成できます。

ヒント

もし展開が失敗した場合、展開ログにアクセスし て何が起きたのか調査し、再度展開を試みることができます。

展開プロセス:

  • 接続されたソース管理アカウントに新しいリポジトリを作成します。

  • あなたが定義した環境でContent Management (CM)インスタンスをホストするためのインフラとSaaSテナントをプロビジョニングします。

  • リポジトリからソースコードをホスティングされたSitecoreAIビルドサーバーに引き寄せてソリューションを構築します。

  • ビルドアーティファクトをプロビジョニング済みのCMインスタンスにデプロイします。

プロジェクトと環境をプロビジョニングしたことで、その環境はSitecore Cloud Portalでアプリとして表示されます。

次にやることは 、サイトとページを作成することです。

Decoupled Deploymentsベータ機能を有効にしたときにプロジェクトをDeployしてください

ベータ機能では以下が可能です:

  • Deployアプリからホストを作成・管理できます。

  • オーサリング環境とホスト編集は別々に構築・展開することで、より高速な展開と独立したログ記録が可能になります。

  • 追加のオーサリング環境を追加したりホストを編集したりする際には、異なるリポジトリのソースコードを活用してください。

  • プロジェクトや環境の作成時にカスタム 環境変数 を追加してください。

ベータ機能が有効になった場合、Deployアプリでfoundationテンプレートを使ってプロジェクトを作成するには:

  1. DeployアプリのProjectsページでCreate projectをクリックします。

    The Create project button in the Deploy app
  2. プロジェクト名をGetting Startedし、Use starter kitが選択されているか確認し、Continueをクリックします。

  3. Set up authoring environmentウィンドウで、オーサリング環境をGetting Startedと名付けます。

  4. プロジェクトで使用するソース管理プロバイダーを選択してください。既存の接続がなければ、Add GitHub accountまたはAdd Azure DevOps accountをクリックし、アカウント内のDeployアプリの認証手順に従ってください。接続は後で ソース管理プロバイダーで管理 できます。

  5. ソース管理プロバイダーアカウントでDeployアプリを承認した後、Deployアプリが環境コードを保存するために作成するリポジトリ名(例えばGetting-Started)を入力してください。

    注記

    リポジトリ名は英数字、アンダースコア、ピリオド、ハイフンのみ、最大100文字までしか含めません。また、ソース管理プロバイダーのリポジトリ命名規則に従う必要があります。

  6. Auto deploy on push to repositoryチェックボックスを選択し、Production SaaS SLAチェックボックスがクリアであることを確認しましょう。

    大事な

    本番環境は本番トラフィックに最適化されており、Sitecore SaaSサービスレベルアグリーメントによってカバーされています。この設定は後で変更できません。

    この時点で、オーサリング環境に環境変数を追加できますが、この入門ガイドには必須ではないので、Continueをクリックしてください。

  7. Set up editing hostウィンドウでAuto deploy on push to repositoryチェックボックスを選択します。スターターキットを使うので、Editing host nameは事前に選ばれています。

    編集ホストの設定は任意ですが、この入門ガイドには必要です。

    注記

    自分のコードを持参して編集ホストを設定したい場合は:

    1. 編集ホストのソースコードを選択するには、Editing host name欄で編集ホストコードリポジトリのxmcloud.build.jsonファイルに定義されたレンダリングホストの名前を入力します。

      XM Cloudは現在SitecoreAIとなっています

      一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

    2. 編集ホストコードを含むソース管理アカウントとリポジトリを選択します。

      詳細は「 編集ホストの管理」をご覧ください。

    この時点で、環境変数を編集ホストに追加できますが、この入門ガイドには必須ではないので、Continueをクリックしてください。

  8. 設定を確認してStart deploymentをクリックします。

  9. 展開は数分間実行され、進捗を確認するために展開ログ画面にリダイレクトされます(数秒かかることもあります)。完成後はSitecoreAIに行って新しいサイトを作成できます。

ヒント

もし展開が失敗した場合、展開ログにアクセスし て何が起きたのか調査し、再度展開を試みることができます。

展開プロセス:

  • 接続されたソース管理アカウントに新しいリポジトリを作成し、Foundationテンプレートからソースコードを新しいリポジトリにコピーします。

  • あなたが定義した環境でContent Management (CM)インスタンスをホストするためのインフラとSaaSテナントをプロビジョニングします。

  • リポジトリからソースコードをホスティングされたSitecoreAIビルドサーバーに引き寄せてソリューションを構築します。

  • ビルドアーティファクトをプロビジョニング済みのCMインスタンスにデプロイします。

プロジェクトと環境をプロビジョニングしたことで、その環境はSitecore Cloud Portalでアプリとして表示されます。

次にやることは 、サイトとページを作成することです。

この記事を改善するための提案がある場合は、 お知らせください!