> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建通用服务

在 `Inference` 模块中找到 `General Service`。点击创建按钮进入创建页面。

<img src="https://mintcdn.com/siflow/vap4jT3tfBA1sSQZ/products/siverse/general_service/media/gs1.png?fit=max&auto=format&n=vap4jT3tfBA1sSQZ&q=85&s=4dafe0021dc884823f2b462538c20fba" alt="gs" width="3006" height="1496" data-path="products/siverse/general_service/media/gs1.png" />

## 填写基础服务信息

* **Service Name**：用于标识服务的自定义唯一名称
* **Service ports**：可配置一个或多个端口用于服务访问
* **BaseURL**：用于指定访问后端的前缀路径

<img src="https://mintcdn.com/siflow/vap4jT3tfBA1sSQZ/products/siverse/general_service/media/gs2.png?fit=max&auto=format&n=vap4jT3tfBA1sSQZ&q=85&s=95959bf9bb906a376813d7cb89e2dfcd" alt="gs" width="2408" height="920" data-path="products/siverse/general_service/media/gs2.png" />

## 配置负载信息

* **Image**：选择或输入服务运行所使用的 Docker 镜像
* **Resource Allocation**：包括 CPU、内存和 GPU 等资源限制
* **Execute command (CMD)**：服务启动时执行的命令
* **Health check probe**：配置存活/就绪探针以确保服务可用性
* **Multi-version support**：一个服务可配置多个工作负载版本，便于升级或回滚

<img src="https://mintcdn.com/siflow/vap4jT3tfBA1sSQZ/products/siverse/general_service/media/gs3.png?fit=max&auto=format&n=vap4jT3tfBA1sSQZ&q=85&s=6f9d07de4747a52810cebd85087d8d2c" alt="gs" width="3024" height="1692" data-path="products/siverse/general_service/media/gs3.png" />

## Baseurl

* BaseURL Enable：当访问入口路径带有前缀时，服务内部同样可以接收到这个完整路径。

  * **Access path**：访问入口自动包含完整的前缀路径，服务端也会接收到相同的完整路径。
  * **Usage**：用于多租户隔离，确保访问路径不冲突。
  * **Service Configuration Requirements**：服务需要处理带前缀的访问路径。例如，当用户访问 `/chat/completion` 时，实际请求路径可能为：`/siflow/cks/ai-infra/xyjiang02/test2/v1/8000/chat/completion`
  * 可通过以下两种方式实现适配：
    1. 服务端支持前缀路径（例如在应用框架中配置 root\_path 或 basePath）
    2. 在自定义 Nginx 配置中添加重写规则，将带前缀的请求转发到服务的原始路径

* BaseURL Disable：访问入口可以自由访问，但服务内部只接收到 `/`（即根路径）。

  * Usage：无需路径隔离的单租户或测试场景。
  * **Service Configuration Requirements**：服务只需支持其自身的 API 路径，无需添加前缀路径。例如，当用户访问 `/siflow/cks/.../chat/completion` 时，Ingress 会自动将请求转发到：`/chat/completion`

| BaseURL | 用户访问的 URL                               | 服务实际接收到的路径                              |
| ------- | --------------------------------------- | --------------------------------------- |
| Enable  | `/cks/ai-infra/xyjiang02/test2/v1/8000` | `/cks/ai-infra/xyjiang02/test2/v1/8000` |
| Disable | `/cks/ai-infra/xyjiang02/test2/v1/8000` | `/`                                     |
