Sevalla

在本教學課程中，您將學習如何準備 Ktor 應用程式並將其部署到 Sevalla。您可以根據用於 建立 Ktor 伺服器 的方式，使用以下其中一個起始專案：

• embedded-server

• Engine-main

先決條件

在開始本教學課程之前，您需要 建立 Sevalla 帳戶（包含 $50 的免費點數）。

複製範例應用程式

若要開啟範例應用程式，請依照以下步驟操作：

1. 複製 Ktor 文件儲存庫。
2. 開啟 codeSnippets 專案。
3. 開啟 embedded-server 或 engine-main 範例，此範例展示了設定 Ktor 伺服器的兩種不同方法 — 可以直接在程式碼中設定，也可以透過外部設定檔設定。部署這些專案的唯一區別在於如何指定用於監聽傳入請求的埠 (port)。

準備應用程式

步驟 1：設定埠 (port)

Sevalla 使用 PORT 環境變數注入隨機埠 (port)。您的應用程式必須設定為監聽該埠。

如果您選擇了伺服器設定在程式碼中指定的 embedded-server 範例，您可以使用 System.getenv() 取得環境變數值。開啟位於 src/main/kotlin/com/example 資料夾中的 Application.kt 檔案，並變更 embeddedServer() 函數的 port 參數值，如下所示：

fun main() {
    val port = System.getenv("PORT")?.toIntOrNull() ?: 8080
    embeddedServer(Netty, port = port, host = "0.0.0.0") {
        // ...
    }.start(wait = true)
}

如果您選擇了伺服器設定在 application.conf 檔案中指定的 engine-main 範例，您可以透過使用 ${ENV} 語法將環境變數指派給 port 參數。開啟位於 src/main/resources 中的 application.conf 檔案並更新，如下所示：

ktor {
  deployment {
    port = 5000
    port = ${?PORT}
  }
  application {
    modules = [ com.example.ApplicationKt.module ]
  }
}

步驟 2：新增 Dockerfile

若要在 Sevalla 上建構 (build) 並執行您的 Ktor 專案，您需要一個 Dockerfile。這是一個使用多階段建構 (multi-stage build) 的範例 Dockerfile：

# Stage 1: Build the app
FROM gradle:8.5-jdk17-alpine AS builder
WORKDIR /app
COPY . .
RUN gradle installDist

# Stage 2: Run the app
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
COPY --from=builder /app/build/install/<project-name>/ ./
ENV PORT=8080
CMD ["./bin/<project-name>"]

請務必將 <project-name> 替換為您 settings.gradle.kts 檔案中定義的專案名稱：

rootProject.name = "ktor-app"

部署應用程式

Sevalla 直接從已連接的 Git 儲存庫建構並部署您的應用程式。該儲存庫可以託管在 GitHub、GitLab、Bitbucket 等平台或任何受支援的 Git 供應商上。若要成功部署，請確保您的專案已提交 (committed) 並推送 (pushed)，並包含所有必要檔案（例如您的 Dockerfile、build.gradle.kts 和原始碼 (source code)）。

若要部署應用程式，請登入 Sevalla 並依照以下步驟操作：

1. 點擊 應用程式 -> 建立應用程式
2. 選擇您的 Git 儲存庫並選取適當的分支 (branch)（通常是 main 或 master）。
3. 設定應用程式名稱，選取區域，並選擇您的 pod 大小（您可以從 0.5 CPU / 1GB RAM 開始）。
4. 點擊建立，但暫時跳過部署步驟
   
5. 前往設定 -> 建構 (Build) 並在建構環境 (Build environment) 卡片下方點擊更新設定。
   
6. 將建構方法設定為 Dockerfile。
7. 確認 Dockerfile 路徑是 Dockerfile 且上下文 (Context) 是 .。
8. 返回您的應用程式的部署分頁，然後點擊部署。

Sevalla 將複製您的 Git 儲存庫，使用您的 Dockerfile 建構 Docker 映像 (image)，注入 PORT 環境變數，並執行您的應用程式。如果一切設定正確，您的 Ktor 應用程式將在 https://<your-app>.sevalla.app 上線。