跳到主要内容
版本：v0.5

单实例部署

适用于PoC或测试场景。

前置条件：

  • 资源不少于4CPU，8Gi内存的Linux服务器。
  • 至少50GB的空余磁盘空间。
  • 安装Docker，详细指引参考Docker官方文档。
  • 服务器开放80和443端口。

使用 Docker Run 指令即可完成标准部署。

sudo docker run -d --privileged --restart=always \
  -p 80:80 -p 443:443 \
  -e SERVER_BUILTIN_CATALOG_PROVIDER=gitee \
  sealio/walrus:v0.5.1

国内用户可以通过 -e SERVER_BUILTIN_CATALOG_PROVIDER=gitee 指定使用 Gitee 作为内置模板源地址。也可以通过 -e SERVER_BUILTIN_CATALOG_PROVIDER=github 指定使用 GitHub 作为内置模板源地址。

配置TLS​

默认方式，使用系统（非公开受信）的自签证书​

由于HTTPs服务证书（链）由非公开受信的CA（Walrus启动创建）签发，用户访问UI前需要在浏览器确认使用风险。

使用 ACME 挑战生成（公开受信）的证书​

通过 Let's Encrypt 服务来执行挑战，挑战成功后由 Let's Encrypt 颁发一个为期90天的 HTTPs 服务证书（链）。该证书（链）的续约工作，由 Walrus 自动完成。

前置条件：

  • 配置一个域名，使该域名能映射到部署Walrus的Linux服务器，例如，walrus.mydomain.com。
  • 开放部署Walrus的Linux服务器的80和443端口，并确保该服务器能够被Let's Encrypt服务访问。
sudo docker run -d --privileged --restart=always \
 -p 80:80 -p 443:443 \
 -e SERVER_TLS_AUTO_CERT_DOMAINS=<YOUR_DOMAIN_NAME> \
 sealio/walrus:v0.5.1

上述采用的是 HTTP-01 挑战模式，如果无法开放80端口，将自动转为使用 TLS-ALPN-01 挑战模式。

sudo docker run -d --privileged --restart=always \
 -p 443:443 \
 -e SERVER_TLS_AUTO_CERT_DOMAINS=<YOUR_DOMAIN_NAME> \
 sealio/walrus:v0.5.1

使用自定义的证书​

自定义的证书是指，使用公开受信或非公开受信的CA证书，签发的HTTPs服务证书（链）。

前置条件：

  • 在部署Walrus的Linux服务器上准备证书文件，例如，在<PRIVATE_KEY_FILE>路径下放置用于HTTPs服务私钥PEM文件，在<CERT_FILE>路径下放置用于HTTPs服务证书（链）PEM文件。
  • 如果有（非公开受信的）CA证书，请并置在<CERT_FILE>路径下的文件中，通常串联在HTTPs服务证书（链）后。
sudo docker run -d --privileged --restart=always \
  -p 80:80 -p 443:443 \
  -v /<PRIVATE_KEY_FILE>:/etc/walrus/ssl/key.pem \
  -v /<CERT_FILE>:/etc/walrus/ssl/cert.pem \
  -e SERVER_TLS_PRIVATE_KEY_FILE=/etc/walrus/ssl/key.pem \
  -e SERVER_TLS_CERT_FILE=/etc/walrus/ssl/cert.pem \
  sealio/walrus:v0.5.1

使用TLS终止​

TLS 终止，通常由反向代理服务执行。

注意：

  • 反向代理服务到Walrus的链路中可使用HTTP请求，并且强化Walrus的会话Cookiewalrus_session为Secure: true以避免中间人攻击。
sudo docker run -d --privileged --restart=always \
  -p 80:80 \
  -e SERVER_ENABLE_TLS=false \
  sealio/walrus:v0.5.1

配置数据库​

Walrus基于PostgreSQL关系型数据库实现数据存储。

默认情况下，Walrus会在运行容器内启动一个 PostgresSQL 的实例，这非常便捷且易于使用，但可能面临使用数据的丢失。为此，用户可以在启动Walrus时，提供外部的PostgreSQL源，以避免使用数据的丢失。

# step 1: Start PostgreSQL with the following command.
docker run -d --restart=always \
  -p 5432:5432 \
  -e "POSTGRES_PASSWORD=Root123" \
  -e "POSTGRES_USER=root" \
  -e "POSTGRES_DB=walrus" \
  postgres:14.6

# step 2: Start Walrus with the following command.
sudo docker run -d --privileged --restart=always \
  -p 80:80 -p 443:443 \
  -e SERVER_DATA_SOURCE_ADDRESS="postgres://root:Root123@<postgres-ip-address>:5432/walrus?sslmode=disable"\
  sealio/walrus:v0.5.1

配置HTTP代理​

如果部署在网络隔离环境，并且可以通过代理访问外网，可以通过配置环境变量的方式设置代理。例如：

sudo docker run -d --privileged --restart=always \
  -p 80:80 -p 443:443 \
  -e HTTP_PROXY="http://192.168.0.100:3128" \
  -e HTTPS_PROXY="http://192.168.0.100:3128" \
  -e NO_PROXY="localhost,127.0.0.1,0.0.0.0,10.0.0.0/8,.svc,.cluster.local,example.com" \
  sealio/walrus:v0.5.1

注意：

  • 如果有任何连接器(K8s、云或任何其他基础设施)想要添加到Walrus，并且应该绕过代理，请确保在运行Walrus时，将其访问地址(例如，kubeconfig中的K8s API server地址、特定云URL的域名或IP地址)合并到“NO_PROXY”配置中。