Extension:Wikispeech/Installing Speechoid/zh

Speechoid is the text-to-speech backend of Wikispeech. It consists of a number of services controlled via Wikispeech-server. The Speechoid build pipeline use Blubber to create Docker images which is meant to be deployed on for instance a Kubernetes cluster, but there is also a Compose project for easy deployment on development servers and small installations.

Please report any errors you encounter in the discussion of this wikipage.



预建镜像
All the Speechoid services are a part of the Wikimedia CI pipeline, and all builds are available in the Wikimedia docker registry. You probably don't need to build your own images.



参选资格
This guide is based on the setup used by the Wikispeech development team that use Ubuntu (18, 19 and 20) as workstations and Debian (10) server side.


 * Docker
 * Blubber - We strongly recommend using the prebuilt binary. Make sure it's available in your $PATH, e.g. by copying it to /usr/local/bin.



使用配置脚本
The docker-compose project comes with a script that will download and build all services for you.



手动构建镜像
Each service lives in its own git repository at gerrit.wikimedia.org:

Each service contains a Blubber-helper script that prepare the image.



开始请求


使用撰写
The easiest way is to spin it up using Docker compose:

If you built your own images you'll need up update the compose file to correspond with your image build tags.

After a little while Wikispeech server should be available as an HTTP service on port 10000.



手动启动语音
As of writing this documentation, there is no ready to go pipeline for starting up in other environments. Speechoid will, when ready for production, be deployed on a Kubernetes cluster.



在云VPS上设置实例
These instructions are for Debian 10 on WMF cloud VPS services, but should be rather generic and reusable for most environments.

Clone and prepare Speechoid docker-compose
Install Docker Compose following the instructions on https://docs.docker.com/compose/install/.



设置为系统服务
The following will automatically start Speechoid on boot.



设置网络代理
现在，您需要在端口 10000 上设置到 Speechoid 的 HTTP 代理传递. Alternatively you could setup a floating IP, but that isn't covered by this guide.

Go to https://horizon.wikimedia.org/project/proxy/ and click the Create Proxy-button. Fill in the information about your VPS and use backend port 10000. Speechoid should now be publicly available as HTTP and HTTPS on port 80 and 443.

To enable transcription preview on Special:EditLexicon, the Symbolset server also needs to be accessible. 此操作如上所述，但端口为 8771.



Pronlex在MariaDB
Out of the box, Pronlex will run on a build in SQLite database. 还支持MariaDB / MySQL.

如果您没有安装 MariaDB：

sudo apt -y update sudo apt -y install software-properties-common gnupg2 sudo apt -y upgrade sudo reboot

Setup your favorite mirror: (I used Kenya for no reason. You might want something more local or more trusted.)

安装MariaDB.

sudo apt install mariadb-server mariadb-client

安全，但不要设置 root 密码. Pronlex expects this (?! really ?!) and will create a user and databases further down.

sudo mysql_secure_installation

安装和设置 GoLang.

Install and build Pronlex.

Populate MariaDB with Lexdata.

Profit!

(You might want to set a password for the MariaDB user speechoid at this point)

(You might want to create a user for remote access for the MariaDB user speechoid using the same password and grants at this point)

(You can now delete all GoLang, Pronlex and Lexdata folders if you want.)

Start the Prolex in your Speechoid pointing it at this MariaDB. Something like:

/bin/bash scripts/start_server.sh -a /srv/appdir -e mariadb -l 'speechoid:password@tcp(wikispeech-tts-pronlex:3306)'

If you are running from docker-compose, you simply uncomment and update the environment variable PRONLEX_MARIADB_URI under section pronlex in the compose file.