從 Kyma [官網](https://kyma-project.io/) 得知，Kyma 是一個雲原生應用程式執行環境，它將 Kubernetes 提供的強大容器編排功能與若干世界級的開源元件和工具相結合，使開發人員能夠開發、執行和操作安全且可擴充套件的雲原生應用程式。

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

Kubernetes 提供了一個框架，用於執行基於容器的分散式系統。 我們可以將容器視為一個非常輕量級的虛擬機器，其中包含一小塊應用邏輯，這些邏輯服務於一些更大的應用程式，也就是微服務。 Kubernetes 提供了許多用於管理容器生命週期的元件，讓開發人員可以選擇應用程式依賴項，例如訊息傳遞匯流排、監控、日誌記錄等。

Kyma 構建於 Kubernetes 之上，解決了與微服務架構、事件消費、身份驗證、日誌記錄、跟蹤、監控和警報相關的需求。 此外，服務目錄允許使用開放服務代理輕鬆使用超大規模提供商提供的雲服務，以及使用應用程式聯結器連線到 Kyma 的服務。 應用程式聯結器允許開發人員輕鬆連線任何應用程式並以安全的方式公開其 API 和事件。

本文透過一個 Node.js 應用開發和部署的例子，來介紹 Kyma 這個雲原生平臺的使用方式。

# 1. Kyma 環境的 provision

登入 SAP BTP 控制檯，點選 `Enable Kyma` 按鈕，啟用平臺對 Kyma 執行環境的支援：

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

建立一個 Kyma 例項：
![](https://img-blog.csdnimg.cn/img_convert/1be696c8084381e440bc647eea3dca83.png)

在後臺，正在建立一個新的 Kubernetes 叢集，Kyma 執行時及其所有元件將在其中執行。 
要開啟 Kyma 執行時控制檯 UI，單擊子賬戶概覽頁面的 Kyma 環境部分下的連結到儀表板。

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

儀表板或 Kyma 控制檯 UI 是開發者在 Kyma 執行時管理和部署應用程式或服務的圖形介面。 使用儀表板，開發人員不僅可以部署或刪除部署，還可以對它們進行擴充套件管理，透過自定義 API 規則公開它們等等。

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

當然，Kyma 執行時是一個 Kubernetes 叢集，因此我們也可以使用工具 kubectl 透過命令列管理資源和配置。

kubectl 工具依賴於一個名為 kubeconfig 的配置檔案來配置對叢集的訪問。

在 Kyma 控制檯下載這個 `kybeconfig` 配置檔案：
![](https://img-blog.csdnimg.cn/img_convert/c8fbcb2ab978e623849fcf100232e4b9.png)

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

然後設定環境變數即可。

- Linux：`export KUBECONFIG=<kubeconfig_file_path>`
- Windows：`$ENV:KUBECONFIG=<kubeconfig_file_path>`

# 2. 使用 Express Generator 建立 Node.js 應用

使用 Express Generator 建立一個 Node.js 應用程式框架，並將一些片段作為基本應用程式新增到後端。

使用命令列：

`npx express-generator --view=jade kyma-multitenant-node`

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

建立好的應用層級結構如下：
![](https://img-blog.csdnimg.cn/img_convert/c5b5f56941d41c944ccb9f3af93500ff.png)

Node.js 應用的路由(`Routing`)是指確定應用程式如何響應客戶端對特定端點的請求，該端點是 URI（或路徑）和特定的 HTTP 請求方法（GET、POST 等）。

每個路由可以有一個或多個處理函式，當路由匹配時執行。

路由定義採用以下結構：

`app.METHOD(PATH, HANDLER)`

增加下列的路由實現，我們就得到了一個最簡單的 Hello World 級別的 Node.js 應用：

```javascript
router.get("/", function(req, res, next) {
    try {
        var line1 = "Hello " + req.authInfo.getLogonName();
        var line2 = "your tenant sub-domain is " + req.authInfo.getSubdomain();
        var line3 = "your tenant zone id is " + req.authInfo.getZoneId();
        var responseMsg = line1 + "; " + line2 + "; " + line3;
        res.send(responseMsg);
    } catch (e) {
        console.log("AuthInfo object undefined.");
        var responseMsg = "Hello World!";
        res.send(responseMsg);
    }
});
```

# 3. 部署 Node.js 應用到 Kyma 雲原生平臺

在 SAP BTP 控制檯上，找到要部署的 tenant 的 subdomain：

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

在 Kyma 儀表板中，在下載的 kubeconfig.yml 檔案或 Kyma 儀表板的 URL 中找到完整的 Kyma 叢集域。

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

為了在 Kyma Runtime（或任何基於 Kubernetes 的平臺）上執行程式碼，我們需要為步驟2 開發的 Node.js 應用程式提供一個 OCI 映像（也稱為 Docker 映像）。 原則上可以自由選擇映像構建工具，本文使用 Cloud Native Buildpacks (CNB)。

命令列工具包支援提供 buildpack 和本地原始碼並從中建立 OCI 映像。

首先安裝命令列工具 `pack`：

`brew install buildpacks/tap/pack`

當我們談到儲存庫名稱時，我們指的是 Docker Hub 中常見的帳戶和儲存庫名稱的組合：

`<docker-hub-account>/<repo-name>`。

比如 tiaxu/multitenant-kyma-backend.

由於只能在 free 的 Docker hub 帳戶中建立一個私有儲存庫，因此儲存在 Docker hub 中的 Docker 映像將具有不同的標記名稱，以便它們可以儲存在一個儲存庫下。 因此，定址影像將包括標籤名稱：`<docker-hub-account>/<repo-name>:<tag-name>`。 一個例子是 `tiaxu/multitenant-kyma-backend:v1`。

使用如下命令列構建映象檔案：

- `pack build multitenant-kyma-backend --builder paketobuildpacks/builder:full`
- `docker tag multitenant-kyma-backend <docker-hub-account>/multitenant-kyma-backend:v1`

下面將構建好的映象檔案釋出到 Docker Hub：

首先登入 Docker：

`docker login -u <docker-id> -p <password>`

然後進行映象釋出：

`docker push <docker-hub-account>/multitenant-kyma-backend:v1`

由於 OCI 映像儲存在 Docker Hub 中，因此我們需要提供對 Kyma 叢集的訪問資訊，以便可以從這些儲存庫中提取映像，並根據 Docker 帳戶替換佔位符值：

`kubectl -n multitenancy-ns create secret docker-registry registry-secret --docker-server=https://index.docker.io/v1/  --docker-username=<docker-id> --docker-password=<password> --docker-email=<email>
`

對應的 yaml 檔案如下：

```yml
imagePullSecrets:
        - name: registry-secret # replace with your own registry secret

```

建立 Kyma 部署描述檔案，這也是一個 yaml 格式的檔案：

```yml
---
apiVersion: gateway.kyma-project.io/v1alpha1
kind: APIRule
metadata:
  creationTimestamp: null
  labels:
    app: kyma-multitenant-node-multitenancy
    release: multitenancy
  name: kyma-multitenant-node-multitenancy
spec:
  gateway: kyma-gateway.kyma-system.svc.cluster.local
  rules:
  - accessStrategies:
    - handler: allow
    methods:
    - GET
    - POST
    - PUT
    - PATCH
    - DELETE
    - HEAD
    path: /.*
  service:
    host: <subaccount-subadomain>-node.<cluster-domain> # replace with the values of your account
    name: kyma-multitenant-node-multitenancy
    port: 8080
status: {}

---
apiVersion: apps/v1
kind: Deployment
metadata:
  creationTimestamp: null
  labels:
    app: kyma-multitenant-node-multitenancy
    release: multitenancy
  name: kyma-multitenant-node-multitenancy
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kyma-multitenant-node-multitenancy
      release: multitenancy
  strategy: {}
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: kyma-multitenant-node-multitenancy
        release: multitenancy
    spec:
      automountServiceAccountToken: true
      imagePullSecrets:
        - name: registry-secret # replace with your own registry secret
      containers:
      - env:
        - name: PORT
          value: "8080"
        - name: TMPDIR
          value: /tmp
        image: <docker-hub-account>/multitenant-kyma-backend:v1  # replace with your Docker Hub account name
        livenessProbe:
          exec:
            command:
            - nc
            - -z
            - localhost
            - "8080"
          failureThreshold: 1
          initialDelaySeconds: 60
          periodSeconds: 30
          successThreshold: 1
          timeoutSeconds: 60
        name: kyma-multitenant-node-multitenancy
        ports:
        - containerPort: 8080
        readinessProbe:
          exec:
            command:
            - nc
            - -z
            - localhost
            - "8080"
          failureThreshold: 1
          initialDelaySeconds: 60
          periodSeconds: 30
          successThreshold: 1
          timeoutSeconds: 60
        resources:
          limits:
            ephemeral-storage: 256M
            memory: 256M
          requests:
            cpu: 100m
            ephemeral-storage: 256M
            memory: 256M
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop:
            - ALL
          privileged: false
          readOnlyRootFilesystem: false
        volumeMounts:
        - mountPath: /tmp
          name: tmp
      securityContext:
        runAsNonRoot: true
      volumes:
      - emptyDir: {}
        name: tmp
status: {}

---
apiVersion: v1
kind: Service
metadata:
  creationTimestamp: null
  labels:
    app: kyma-multitenant-node-multitenancy
    release: multitenancy
  name: kyma-multitenant-node-multitenancy
spec:
  ports:
  - port: 8080
    protocol: TCP
    targetPort: 8080
  selector:
    app: kyma-multitenant-node-multitenancy
    release: multitenancy
status:
  loadBalancer: {}

---
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  creationTimestamp: null
  labels:
    release: multitenancy
  name: multitenancy
spec:
  ingress:
  - from:
    - namespaceSelector:
        matchLabels:
          name: istio-system
      podSelector:
        matchLabels:
          app: istio-ingressgateway
  podSelector:
    matchLabels:
      release: multitenancy
  policyTypes:
  - Ingress
```

使用下列的命令列進行部署：

`kubectl -n multitenancy-ns apply -f k8s-deployment-backend.yaml`

部署成功後，回到 Kyma 控制檯，找到自動生成的能訪問該 Node.js 應用的 url：

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

至此，Node.js 應用的開發，以及部署到 Kyma 雲原生平臺的步驟就介紹完畢。</docker-hub-account></cluster-domain></subaccount-subadomain></email></password></docker-id></docker-hub-account></password></docker-id></docker-hub-account></tag-name></repo-name></docker-hub-account></repo-name></docker-hub-account></kubeconfig_file_path></kubeconfig_file_path>

在 Kyma 雲原生平臺上開發並部署 Node.js 應用

相關文章