Wikibase/Docker/ja

ウィキベースチームはメディアウィキ、ウィキベース及び関連サービスをまとめたDockerイメージを定期的に公開しています. 少しカスタマイズするだけで、お望みのウィキベースインスタンスを正確にインストールできます.



始める前に

 * You’ll need to have docker and docker-compose installed on the computer where you want to run your Wikibase instance. （このステップのヘルプが必要な場合はページ下部にあるリンクのリストを参照してください. ）
 * ウィキベースチームはすべてのサービスを含む完全なDockerインストールに、最低8GiBのメモリを推奨します.
 * You can get quick insight into your Docker resource usage with the  command; also check out Docker’s documentation on resource constraints.



環境の準備
Examine the files in the example directory of the wikibase-release-pipeline repository. 以下に示すように、これらのファイルのコピーを保存し、それを使ってあなたのバージョンのDockerイメージを起動します.

You'll need a  file much like the one provided in the   directory, and an optional   (see below for context). ファイルも必要です.

'''新しいディレクトリを作成します.  Copy the  file into that directory, and copy the   in the example directory into your new directory as a file named  .''' ''' ファイルを編集し、passwordsとsecretsを独自のものに置き換えます. '''

 メディアウィキの構成
 * MW_ADMIN_NAME
 * MW_ADMIN_PASS
 * MW_ADMIN_EMAIL

これらの値はメディアウィキのインストールに使用されます. 新しいインスタンスのwebインターフェースに初めてログインするとき、ここで指定したユーザー名とパスワードを使用します. メールアドレスはパスワードの復旧などに使用します.



この秘密鍵は一意である必要があります. メディアウィキはこれをいくつかの目的にしようします（セッション管理、暗号化エントロピー源の代わりなど）. 詳しくはリンクをご覧ください.

 データベースの構成
 * DB_NAME
 * DB_USER
 * DB_PASS

ここで指定したデータベース名、ユーザー名、パスワードがインストールに使用されます.

 ウィキベースの設定
 * WIKIBASE_PINGBACK=false

既定では、Wikibase pingbackは無効です. Please consider enabling this feature (which sends only anonymized data) by changing  to.

この機能を有効にすると、ウィキメディア・ドイツはウィキベースの使用状況の見識をはっきりと向上させることができ、より情報に基づいた開発方針の決定ができるようになります. For more information, read our pingback documentation topic.


 * WIKIBASE_HOST=localhost
 * WIKIBASE_PORT=80

これらはウィキベースの公開ホスト名とポート番号（ウィキベースにアクセスする際にブラウザのアドレス欄に入力するもの）を設定します. If you’re using QuickStatements (see below), the same host and port must also be reachable from within the QuickStatements container, which means it can’t be  (since that would refer to the QuickStatements container); if you want to run a local Wikibase with QuickStatements, you can use a private IP address (e.g., 192.168.0. x ) as a local but non-  host name. Docker Desktop for Mac does not allow specifying a service host IP (i.e., per-container IP addressing is not possible), but on Mac systems it is possible to use  instead.



最小インストール
At this stage, you have what you need to install MediaWiki (running on port 80) with Wikibase and a MySQL (MariaDB) backing database.

In the folder where you placed  as mentioned above, simply run:



拡張インストール
You may also wish to run additional services like the query service (WDQS), QuickStatements (see here for more information) and Elasticsearch.

To run these additional services we need to bring the containers up and specify both configurations by running:

注記
Both install processes end up launching two Docker containers:



The example invocations of  use the   flag to start the containers in the background. You can omit this flag to run in the foreground, or, if you simply wish to view the continuous output, you can subsequently run.

Job runner
The example docker-compose.yml sets up a dedicated job runner which restarts itself after every job, to ensure that changes to the configuration are picked up as quickly as possible.

If you run large batches of edits, this job runner may not be able to keep up with edits. You can speed it up by increasing the  variable in your   file, to run more jobs between restarts, if you’re okay with configuration changes not taking effect in the job runner immediately.

Alternatively, you can run several job runners in parallel by adding an option like  to the docker-compose up command.



インストール後
1. Verify that all the services have started: run. You should see something like this: Name                   Command             State         Ports - example_mysql_1     docker-entrypoint.sh mysqld   Up      3306/tcp example_wikibase_1  /bin/bash /entrypoint.sh      Up      0.0.0.0:80->80/tcp

2. Log into your local machine.

3. You may check the logs for success, further information or errors using this command:

If you would like to create links between MediaWiki and Wikibase, make sure to run the add site script. Otherwise, you will see error messages like "The provided site identifier was not recognized".

For more detailed information, check out the README in the examples section of the wikibase-release-pipeline repository.

Using your new instance
Once all the services have started, you can begin the exciting process of filling up, extending and customizing your empty instance of Wikibase. Take a look at our setup resources page to get started.



更なる情報

 * DigitalOcean's tutorial on docker-compose for Linux
 * Microsoft's tutorial on Docker for Windows