天天看點

如何建構和部署 SAP Commerce Cloud 項目

原文連結

SAP Commerce Cloud 提供了許多自助服務功能來配置、建構和部署商務解決方案。 當您第一次開始使用時,似乎需要了解很多。在本文中,我們将帶您逐漸了解如何使用自助服務功能來配置您的應用程式,然後是如何建構和 部署到您的開發環境。 按照本文中的步驟操作後,您應該可以輕松添加任何其他自定義并将它們部署到您選擇的環境中。 在閱讀本文之前,我們建議您閱讀我們關于 SAP Commerce Cloud 入門的文章,其中涵蓋了我們将在本文中提及的一些概念/術語。 您可能還希望檢視産品文檔的初始設定和店面驗證部分,本文将對此進行擴充。

如何建構和部署 SAP Commerce Cloud 項目

Initial Access to SAP Cloud Portal

在考慮建構和部署項目之前,您應該先花點時間熟悉一下 Cloud Portal,它是用于管理 SAP Commerce Cloud 解決方案的自助服務工具。 要通路 Cloud Portal,您需要擁有 SAP 使用者 ID(S 使用者)并且已被具有客戶系統管理者角色的人員授予通路權限。 如果您不确定您的超級管理者是誰,您可以導航到

https://launchpad.support.sap.com/#/user/management

,選擇“重要聯系人”,然後尋找具有“超級管理者”身份的人 “ 角色。 然後他們可以授予您通路權限。

假設您是超級管理者或有人授予您角色,您可以通路

https://portal.commerce.ondemand.com/

。 如果您的密碼有問題,請參閱産品文檔中的此頁面。 確定您還使用受支援的浏覽器。

登入後,您應該確定配置了一些環境。 您可以通過單擊雲門戶左上角的“環境”按鈕來執行此操作。 您應該至少有 1 個開發、1 個階段和 1 個生産環境(如果您需要更多環境,可以購買)。 如果您沒有看到任何已配置的環境,則需要找到您的超級管理者才能使用 SAP Customer Experience Cockpit 中的自助服務環境配置。

Connect an Empty Git Repository

下一步是連接配接您将用于維護将在 SAP Commerce Cloud 上建構和部署的代碼的空 Git 存儲庫。 SAP Commerce Cloud 的每個訂閱都能夠連接配接到一個基于 Git 的存儲庫。 git 存儲庫需要位于公共可通路的伺服器上(不在公司環境中的防火牆後面)。 可以通過 SSH 和 HTTPS 方法進行通路。

Set Up Your Git Repository

現在您的 Git 存儲庫已連接配接,本節将幫助您完成使用代碼填充存儲庫的步驟。 産品文檔中有一個廣泛的部分,您可以通過各種方式填充存儲庫,但是如果您正在尋找一個工作模闆來幫助您入門,那麼您可以下載下傳各種代碼示例來初始填充存儲庫。 本節将介紹如何開始使用示例代碼,其中包含基于 Spartacus 的工作店面和基于加速器的示例店面的結構。

Get it Working Locally

鑒于您的開發團隊很可能在本地開發和測試自定義,您應該嘗試建構您的存儲庫以允許在本地和您的 SAP Commerce Cloud 環境中進行建構。為此,您需要記住以下幾點:

確定您使用 gitignore 檔案僅将未作為 SAP Commerce Cloud 建構自動化過程的一部分自動添加的項目上傳到您的存儲庫。

例如,您不應添加 SAP Commerce“bin”檔案夾,因為您在清單檔案(見下文)中聲明的相關擴充将作為建構的一部分自動添加。

示例代碼假設您希望在本地使用 Cloud Hot Folders 進行開發。如果您使用的是 SAP Commerce 核心版本 2005,則包含 sap-ccv2-hotfolder 子產品。如果您使用的是 Commerce core 1905,則需要從 Cloud Extension Pack 擷取擴充。

即使您沒有使用可選的雲擴充包,您也需要下載下傳該工件,因為您将需要它附帶的 sap-ccv2-hotfolder 子產品。如果您使用的是 Cloud Extension Packs,那麼您将需要所有代碼。要下載下傳在 launchpad.support.sap.com 中搜尋“CX Comm”并選擇适合您版本的“Ext Pack”。有關更多資訊,請參閱産品文檔中的在本地環境中測試雲熱檔案夾。如果您使用的是 Commerce core 6.7-1811,請參閱此 SAP Note。

您将需要一份您将使用的 SAP Commerce 核心最新更新檔版本的副本。請參閱此頁面以了解如何下載下傳。

現在您已準備好在本地開始,請執行以下操作:

克隆您将在其中存儲代碼的空 git 存儲庫

(可選)如果您想從一開始就正确地開始您的代碼審查過程,您可能需要建立一個“開發”和“功能”分支,您将在其中存儲您的代碼

使用我們的開源示例存儲庫選擇一個分支并下載下傳此代碼示例的 zip。 注意:代碼示例存儲庫包含多個分支,每個分支涵蓋一個不同的用例(資料中心、spartacus、vanilla)。 您可以選擇不同的分支,但在本示例中,我們使用的是 Spartacus 分支。

如何建構和部署 SAP Commerce Cloud 項目

将示例代碼檔案解壓縮到您克隆 git 存儲庫的位置

在其他位置解壓縮 SAP Commerce 核心的副本

将以下檔案夾從解壓縮的 SAP Commerce 核心目錄移動到步驟 #4 中的 core-customize/hybris/bin:hybris/bin/modules 和 hybris/bin/platform

(可選)如果您使用的是 Cloud Extension Pack,則從步驟 4 中解壓縮“hybris/bin/modules/”的内容并将其複制到“hybris/bin/modules-cep”目錄中

完成産品文檔中安裝步驟的以下部分的步驟:設定 Apache Ant

運作以下代碼,以確定正确加載您的附加元件:

ant addoninstall -Daddonnames=“promotionenginesamplesaddon,smarteditaddon,textfieldconfiguratortemplateaddon,assistedservicestorefront,assistedservicepromotionaddon,customerticketingaddon,orderselfserviceaddon,adaptivesearchsamplesaddon,multicountrysampledataaddon,pcmbackofficesamplesaddon,personalizationaddon” -DaddonStorefront.yacceleratorstorefront=“yacceleratorstorefront”

繼續執行産品文檔中安裝步驟的以下部分:

(1)執行建構過程

(2)啟動應用伺服器并部署應用

(3)初始化 SAP Commerce

一旦您的 SAP Commerce Cloud 解決方案在本地運作(例如,您可以通路 localhost:9001/hac),現在就可以在本地建構和運作您的 Spartacus 店面。 為此,請導航到 js-storefront/spartacusstore

執行以下指令,這将建構并運作您的店面:

yarn build

yarn start

您現在應該有運作 SAP Commerce 和 Spartacus 店面的本地執行個體。 要确認 Spartacus 店面正在運作,請導航到 http://localhost:4200

Review and Configure Your Build Manifest

建構清單( build manifests ) 使您能夠根據您的具體規範配置 SAP Commerce Cloud 解決方案。 您可以使用 manifest.json 檔案定義建構過程,該檔案存儲在您的代碼存儲庫中。 示例 manifest.json 檔案已包含在我們上面提供的示例代碼中。 對于此步驟,您應該檢視清單檔案以確定您了解每個元件的用途以及示例的配置方式。 建議您在開始時盡量減少更改,以確定它首先與 Cloud Automation 工具配合使用。 您将來可能會做出的一些更改包括:

commerceSuiteVersion - 您使用的 SAP Commerce Core 版本

useCloudExtensionPack - 如果您想啟用雲擴充包

storefrontAddons - 如果您在 localextensions.xml 檔案中啟用了任何其他附加擴充,則應確定它們包含在您的清單中

aspects - 為任何預定義的 aspects 定義任何屬性和 web 應用程式

tests - 如果您的擴充中有任何測試希望作為 Cloud Automation 建構的一部分運作,則應将它們包含在此處

Commit to Your Git Repository

此時您現在可以在本地建構,是以您應該送出代碼并将其推送到您的 git 存儲庫。

The Initial Build

此時,您已确認您的代碼在本地運作,已簽入您的 Git 存儲庫,您已配置端點并管理您的安全設定。 下一步是建構代碼。産品文檔的此頁概述了這些步驟。如果由于某種原因您的建構失敗,您可以檢視建構日志,修複任何問題并重試建構。

如何建構和部署 SAP Commerce Cloud 項目

部署完成後,您可以打開 JS Storefront 端點的 URL,您應該會看到 Project Spartacus 店面。

繼續閱讀