---
url: /zh/repo/settings-workspace.md
description: 介绍如何通过 .cnb/settings.yml 定制云原生开发启动按钮的名称、描述、悬浮图片、CPU 配置及禁用选项，个性化开发环境入口。
---
定制云原生开发启动按钮的外观和行为，让开发者一眼就能认出你的项目。

## 使用场景

* 为开源项目打造独特的启动体验
* 突出项目的开发环境特色
* 控制开发环境的资源配置（如 CPU 核心数）
* 禁用默认启动按钮（如使用自定义流水线替代）

## 配置方式

在 `.cnb/settings.yml` 中添加 `workspace` 配置：

```yaml title=".cnb/settings.yml"
# 云原生开发配置
# 注意：读取云原生启动按钮所在页面当前分支的 .cnb/settings.yml 配置
workspace:
  launch:
    # 定制云原生开发启动按钮
    button:
      # 按钮名称
      name: 启动云原生开发
      # 按钮描述
      # 如果值为 null，则不显示默认描述
      description: 点击此按钮启动云原生开发环境
      # 鼠标悬浮在按钮上显示的图片
      # 1.用仓库中当前分支的图片，填写相对仓库根目录的路径，如 .cnb/launch-hover.gif;
      # 2.使用当前域名下的文件 raw 地址，比如：https://cnb.cool/my/test/-/git/raw/main/launch-hover.gif
      # 图片最大 10MB
      hoverImage: .cnb/launch-hover.gif
    # CPU 核心数，默认为：8。仅对默认模版有效，如果有自定义云原生开发启动流水线，则此配置无效
    cpus: 4
    # 是否禁用默认按钮。默认为：false 表示不禁用。true 表示禁用
    disabled: false
    # 环境创建完是否自动打开 WebIDE，默认为 false
    # 当开发环境中未安装 openssh(仅支持 WebIDE)：无论此参数配置为 true 还是 false，环境创建完都将自动打开 WebIDE
    autoOpenWebIDE: false
```

## 参数说明

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `workspace.launch.button.name` | string | - | 启动按钮的名称 |
| `workspace.launch.button.description` | string | null | - | 按钮描述，设为 `null` 则不显示默认描述 |
| `workspace.launch.button.hoverImage` | string | - | 鼠标悬浮时显示的图片，支持仓库相对路径或 raw 地址，最大 10MB |
| `workspace.launch.cpus` | number | 8 | CPU 核心数，仅对默认模版有效 |
| `workspace.launch.disabled` | boolean | false | 是否禁用默认启动按钮 |
| `workspace.launch.autoOpenWebIDE` | boolean | false | 环境创建完是否自动打开 WebIDE |

:::tip
所有参数均为可选参数，按需配置即可。
:::