https://developers.sap.com/tutorials/cp-kyma-redis-function.html

> This sample provides a Redis deployment and two serverless functions that interact with it.

這個例子提供了一個 Redis 應用部署和兩個使用 Redis 的 serverless 函式。

> The function cache-order will be set to subscribe to an order.created event provided by the Commerce mock application.

Commerce Mock 應用有一個 order.created 事件，cache-order 函式訂閱這個事件。

> Once triggered, the function will perform an API call to the Commerce mock to obtain additional details regarding the order and then cache the information into Redis.

一旦 order.created 事件觸發，cache-order 函式響應該事件，呼叫一個 Commerce Mock API，讀取建立訂單的更多明細，然後將資料儲存到 Redis 裡。

> The function get-order, exposed as an API, is used to then retrieve the order details from the Redis cache.

函式 get-order, 以 API 的形式暴露，負責從 Redis cache 裡讀取訂單明細。

從這個[Github倉庫](https://github.com/SAP-samples/kyma-runtime-extension-samples)裡下載 sample 程式碼。

進入 Kyma 控制檯，點選 Create Binding：
![](https://img-blog.csdnimg.cn/img_convert/c17eef21e5dcac01d0696f60a52249f1.png)

> In this step, you will bind the Commerce Mock application to the dev namespace. This will allow the APIs and Events of the mock application to be used within the namespace.

這一步會將 Commerce Mock 應用同 dev 名稱空間繫結在一起，這使得 Mock 應用的 API 和 Events 能夠在 dev 名稱空間內被使用。

![](https://img-blog.csdnimg.cn/img_convert/4a5314a5bef5c8bcef70462e93710281.png)

點選 Create：
![](https://img-blog.csdnimg.cn/img_convert/cee8acd1e3ff636844e6f5aa4d31c03a.png)

![](https://img-blog.csdnimg.cn/img_convert/d3f4c7d06652efc5bf8f8c296116a647.png)

# Create the Events service instances - 建立事件服務例項

> In this step, you will create service instances of the Events the Commerce Mock application exposes. This will allow the events to be consumed from resources within the namespaces such as functions or microservices.

建立 Commerce Mock 應用暴露的事件的服務例項。這樣，dev 名稱空間下的資源，比如 functions 和 microservices 就能夠消費這些事件。

選擇 commerce-mock：

![](https://img-blog.csdnimg.cn/img_convert/fe44f442fee592e9c27c4af6c2284497.png)

選擇 SAP Commerce Cloud - Events：
![](https://img-blog.csdnimg.cn/img_convert/185cf838d4e1d5fe9fc38dad0e8b4578.png)

點選 Add 按鈕，建立一個 Service 例項：
![](https://img-blog.csdnimg.cn/img_convert/53caf042b2944b67599461c99b1e5604.png)

![](https://img-blog.csdnimg.cn/img_convert/d8909d0153c2eacbf41d14b2d86895d3.png)

建立好的 service 例項：
![](https://img-blog.csdnimg.cn/img_convert/60ae6d5338b89e33d600df8752a863fb.png)

# Step 4: Create API service instances

> In this step, you will create a service instance of the Commerce Webservices the Mock application exposes.

Mock Application 暴露的 Commerce Web Service, 可以基於其建立服務例項。該服務例項能夠將 API 暴露給同一名稱空間下的其他資源，比如函式和微服務。

![](https://img-blog.csdnimg.cn/img_convert/02d03157e48ec6b81caf7e0e69e4b9e7.png)

![](https://img-blog.csdnimg.cn/img_convert/a898b1a1a03138b2e083787a72626f9a.png)

檢視兩個成功建立的服務例項：
![](https://img-blog.csdnimg.cn/img_convert/3ac1477f50b03818652283c881fdb03a.png)

下一步，部署三個資源到 Kyma 上：

1. cache-order: This function will subscribe to an event published by the Commerce mock application. Once triggered, it will call back to the Commerce mock application to obtain the totalPriceWithTax and then cache the information into Redis.

該函式訂閱 Commerce Mock Application 暴露的 order.created 事件。該事件發生後，cache-order 函式呼叫 Commerce mock Application，獲得 totalPriceWithTax,然後儲存到 Redis 去。

2. get-order: This function will be exposed as an API allowing retrieval of data stored within the Redis cache.

Redis cache 裡透過 cache-order 儲存的訂單資訊，透過 get-order 暴露給消費者。

3. redis-deployment: This deployment defines the Redis cache configuration and the associated Kubernetes service which exposes the Redis instance to the two Serverless functions.

這個 deployment 定義了 Redis cache 配置資訊，以及關聯的 Kubernetes Service, 後者將 Redis 例項暴露給(1)(2) 兩個 serverless 函式使用。

依次將 k8s 資料夾下的 yaml 檔案進行部署：

![](https://img-blog.csdnimg.cn/img_convert/b23b3a932d11df8b373dc371e5f0e0f3.png)

確保 deployment 狀態全部為 Running：
![](https://img-blog.csdnimg.cn/img_convert/90e2ff9a6fa8233232763fa714625e10.png)

# Add event subscription to function

> In this step, you will configure the function cache-order, deployed in the previous step, to run when the order.created event is fired from the Commerce Mock application.

這一步，將 cache-order 訂閱到 order.created 事件上。

從 functions 列表裡找到 cache-order:

![](https://img-blog.csdnimg.cn/img_convert/fae00d5be3870f713f17b8e7021af0b6.png)

建立一個事件訂閱 Event subscription：
![](https://img-blog.csdnimg.cn/img_convert/8d1ed4c5088e2d2eb389228f61a17a23.png)

![](https://img-blog.csdnimg.cn/img_convert/ea04b83641f5c664a3f0633adffae110.png)

cache-order function 需要呼叫對應的 API，因此需要為其建立 service binding.
![](https://img-blog.csdnimg.cn/img_convert/09a3fc807eb682cc692109cc5e89c292.png)

透過這個 Service Binding，就可以藉助該 Service Instance，呼叫 Commerce Webservice了：
![](https://img-blog.csdnimg.cn/img_convert/dbe65c323d1551f86189123deb6e6e36.png)

# 對 function 程式碼進行微調

![](https://img-blog.csdnimg.cn/img_convert/57cf0c4bda5471a6b78ee045acfb2e5c.png)

找到環境變數裡包含 GATEWAY_URL 的變數：
![](https://img-blog.csdnimg.cn/img_convert/4fb5d8142135f619ace8e314e0a744d9.png)

點選 commerce-mock 的 host 超連結，手動觸發一個 order.created 事件。
![](https://img-blog.csdnimg.cn/img_convert/9a2c334f7f9e97082243e09255b834ce.png)

點選 Remote API：
![](https://img-blog.csdnimg.cn/img_convert/0538ac1f881febac9780326c4ba877ed.png)

找到 SAP Commerce Cloud - Events：
![](https://img-blog.csdnimg.cn/img_convert/39757e7f1e1a3e1773f6a79783c48fda.png)

點選按鈕 Send Event，模擬傳送一個 order.created 事件，payload 裡包含的 orderCode 為 76270000：

![](https://img-blog.csdnimg.cn/img_convert/81b06d3396efc5c4ca32cc9ba1a0ba54.png)

事件成功傳送：
![](https://img-blog.csdnimg.cn/img_convert/c8a07e364c6cbf9e2f9a57bb28790336.png)

在 cache-order 的 logs 皮膚裡，果然看到了訂單 code 76270000 對應的處理日誌：

![](https://img-blog.csdnimg.cn/img_convert/7974ecc9ba2f410bc29ec2830ee57e45.png)

下一步，再試試 get-order 函式，是否能夠從 Redis cache 中讀取訂單資訊。

點選這個超連結：https://get-order.c-46d70f2.kyma.shoot.live.k8s-hana.ondemand.com/
![](https://img-blog.csdnimg.cn/img_convert/2a6a0659e9f5653c91516d97db1f295c.png)

會收到如下錯誤訊息："error": "No orderCode received!"
![](https://img-blog.csdnimg.cn/img_convert/03317f1d196670ce11090efe5fc001b4.png)

這是因為我們尚未為該 serverless function 指定 orderCode.

試試在 url 後手動加上 orderCode：

https://get-order.c-46d70f2.kyma.shoot.live.k8s-hana.ondemand.com/?orderCode=76270000
![](https://img-blog.csdnimg.cn/img_convert/e4db92cefd2ba1e33b2fd73051f51510.png)

現在就能夠正常工作了。

在 SAP BTP Kyma Runtime 上使用 Redis 讀取和儲存資料

相關文章