跳到主要内容
版本:0.6.7

swcli server

概述

swcli [全局选项] server <SUBCOMMAND> [参数]...

server 命令包含以下子命令:

  • start
  • stop
  • status (ps)

swcli server start

swcli [全局选项] server start [选项]

server start 使用 Docker 和 Docker-Compose 在本地环境快速启动 Starwhale Server。

  • 依赖要求: Docker >= 19.03, Docker-Compose >= v2。可以使用 swcli check 命令检查。
  • server start 后,需要通过 swcli server stop 来关闭。
  • server start 启动的相关容器,重启策略为 restart=always,即使机器重启,相关容器也会自动启动。
  • server start 会在 ~/.starwhale/.server 目录中渲染 docker compose yaml文件。docker compose 命令可以使用该文件,进行更丰富的操作,比如查看日志: docker compose -f ~/.starwhale/.server/docker-compose.yaml logs -f

参数说明

选项必填项类型默认值说明
-h--hostNString127.0.0.1Starwhale Server 启动端口绑定的IP,默认为 127.0.0.1, 如果希望其他机器能访问可以设置为 0.0.0.0。
-p--portNInt8082Starwhale Server 绑定的端口。
-e--envNString设置环境变量,供 Starwhale Server 启动或运行中使用,比如 SW_PYPI_INDEX_URLSW_PYPI_EXTRA_INDEX_URL 环境变量可以改变 Starwhale Server 的 PYPI 源。
-i--server-imageNStringStarwhale Server 的Docker Image,如不指定,则会使用 swcli 命令行对应版本的 Starwhale Server Image。
--detach/--no-detachNBool--detach后台运行 Starwhale Server。
--dry-runNBoolFalse不真正运行,只产生compose yaml,并做一些校验,一般用来做调试。

Server 启动的例子

# Start Starwhale Server with default settings, then you can visit http://127.0.0.1:8082 to use Starwhale Server.
swcli server start

# Start Starwhale Server with custom Server image.
swcli server start -i docker-registry.starwhale.cn/star-whale/server:latest

# Start Starwhale Server with custom host and port.
swcli server start --port 18082 --host 0.0.0.0

# Start Starwhale Server in the foreground and custom environment variables for pypi.
swcli server start --no-detach -e SW_PYPI_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple -e SW_PYPI_EXTRA_INDEX_URL=https://mirrors.aliyun.com/pypi/simple

swcli server stop

swcli [全局选项] server stop

server stop 命令会停止 swcli server start 启动的相关容器,关闭 Starwhale Server 服务。

swcli server status

swcli [全局选项] server status

server status 命令展示 Starwhale Server 相关容器状态。swcli server ps 命令与该命令作用一致。