smartbear/ready-api-virtserver

ReadyAPI VirtServer Docker镜像

包含ReadyAPI VirtServer最新构建的Docker镜像

关于log4j漏洞CVE-2021-44228

请使用3.7.3或更高版本。该版本已缓解log4j漏洞。
注意- 若已迁移至基于IB的许可证，请参考本文档底部的说明。

运行VirtServer Docker镜像

使用docker run（或Docker Cloud等平台的等效命令）时，通过设置环境变量在外部与Docker镜像间传递信息。在Docker Cloud等平台中，这些变量通常通过表格配置；在命令行中，作为docker run命令的参数传递：

console
docker run -e EnvironmentVariable1Name=EnvironmentVariable1Value -e EnvironmentVariable2Name=EnvironmentVariable2Value smartbear/ready-api-virtserver

通过docker run运行镜像时，也可使用--env-file参数指定包含所有环境设置的文件。详见Docker手册。

*通常需要设置一次。若多次运行间重用存储卷（/virtserver/），传递的值将持久化。若卷持久化，重用VirtServerUser和VirtServerPassword环境变量将添加或更新用户数据库。

VirtServer配置

在Docker中运行VirtServer时，默认配置文件位于/virtserver/。使用HTTPS时，默认配置文件为/virtserver/virt-server-docker-https.yml；使用HTTP时，为/virtserver/virt-server-docker.yml。通过设置环境变量CONFIG（-e CONFIG=/virtserver/some-file.yml）可指定其他文件（需传输至容器卷），这要求卷在多次运行间保持持久化。

使用HTTPS进行管理

除非在安全内部环境中运行，否则建议使用HTTPS而非HTTP进行客户端（通常为ReadyAPI Virtualization）与服务器间的通信。默认使用HTTPS；若需使用HTTP，指定-e UseHTTPS=false。

镜像默认包含预生成的自签名证书。通过-e CertificateSubject可生成新的自签名证书并替换默认证书。

使用非自签名证书

自签名证书虽能防止网络嗅探，但在其他方面被视为不安全，多数浏览器会警告。有关安装可信证书的详细信息，请参考VirtServer文档。

重要：运行Docker镜像时，必须在多次运行间持久化/virtserver存储卷，以保留已安装的证书、添加的用户、部署的虚拟服务及配置更改。通过docker run的-v参数可实现卷挂载（详见Docker文档）。

使用示例

以下是通过docker run运行VirtServer的完整示例：

console
docker run -v /opt/virtserver:/virtserver -p9090:9090 -p 8000-8010:8000-8010 -e UseHTTPS=true -e ACCEPT_TOU=true \
 -e VirtServerUser=john.smith -e VirtServerPassword=secret -e VirtServerUserRole=admin -e DockerUser=virtserver1 \
 -e VirtServerLicenseServer=172.0.64.128:1099 smartbear/ready-api-virtserver

命令参数说明

传递系统属性

通过前缀为JVM_OPT_的环境变量可向Java进程传递任意命令行参数。例如，要设置TestServer的server.port.http配置属性，可定义环境变量JVM_OPT_HTTP_PORT，值为-Dserver.port.http=XXXX。

暴露端口

确保暴露虚拟服务（Virts）所需的端口！

使用新的SmartBear ID-based许可证

若要在Docker容器中使用新的SmartBear ID-based许可证运行VirtServer，需先运行docker login命令，然后根据许可证托管位置使用以下命令（替换为实际值）：

SmartBear ID-based许可证托管在SmartBear许可证服务器：

console
docker run -v /opt/virtserver:/virtserver -p 9090:9090 -p 8000-8010:8000-8010 -e VirtServerUser=User-Name -e VirtServerPassword=Smith -e VirtServerUserRole=admin -e DockerUser=VirtServerLicenseUser -e ACCEPT_TOU=true -e SlmAccessKey=<SLM access key> docker.io/smartbear/ready-api-virtserver:latest

SmartBear ID-based许可证托管在客户本地许可证服务器：

console
docker run -v /opt/virtserver:/virtserver -p 9090:9090 -p 8000-8010:8000-8010 -e VirtServerUser=User-Name -e VirtServerPassword=Smith -e VirtServerUserRole=admin -e DockerUser=VirtServerLicenseUser -e ACCEPT_TOU=true -e SlmServerUrl=<SLM许可证服务器地址，需包含端口40892> -e SlmAccessKey=<SLM access key> docker.io/smartbear/ready-api-virtserver:latest

请根据实际情况添加参数值。 docker run命令启动容器并指定必要参数，上述命令包含启动VirtServer所需的基本参数。