Docker fig搭建mediawiki

fig，无花果。fig项目源自docker，可以认为是快速搭建基于Docker的隔离开发环境的工具。

一、安装fig

  $ mkdir docker; cd docker  
    
  $ curl -L https://github.com/docker/fig/releases/download/1.0.1/fig-`uname -s`-`uname -m` > fig  
    
  $ sudo chmod +x fig; sudo mv fig /usr/local/bin/  

二、搭建mediawiki

使用个人构建的镜像，github地址：https://github.com/bopjiang/wikimedia-docker

在docker目录下执行如下命令：

  $ git clone https://github.com/bopjiang/wikimedia-docker.git  
  $ cd wikimedia-docker  
  $ fig up -d  

此时有两个容器启动：

  r$ docker ps  
  CONTAINER ID        IMAGE                           COMMAND                CREATED             STATUS              PORTS                  NAMES  
  21182a060c17        nickstenning/mediawiki:latest   "/usr/bin/mediawiki-   7 hours ago         Up 7 hours          0.0.0.0:8880->80/tcp   wikimediadocker_wiki2_1     
  728ec09c3552        mysql:5.7.5                     "/entrypoint.sh mysq   7 hours ago         Up 7 hours          3306/tcp               wikimediadocker_db_1      

三、fig.yml

fig.yml用来配置镜像构建的具体内容，此wiki的fig.yml在wikimedia-docker目录下，内容如下：

  wiki2:  
      image: 'nickstenning/mediawiki'  
      ports:  
          - "8880:80"  
      links:  
          - db:database  
      volumes:  
          - /data/wiki2:/data  
    
  db:  
      image: "mysql:5.7.5"  
      expose:  
          - "3306"  
      environment:  
          - MYSQL_ROOT_PASSWORD=defaultpass  

image：用来指定镜像，如果本地没有，fig将会尝试去远程pull这个镜像。
ports：暴露的端口.

links：在其他服务中连接容器。

volumes: 卷挂载路径，容器中的/data/目录挂载到主机的/data/wiki2下。在wiki配置完毕后，将LocalSettings.php文件放置在主机的/data/wiki2目录下。

expose：也是暴露端口，与ports的区别是不发布到宿主机的端口，只被连接的服务访问。

environment：设置环境变量。

四、wiki的配置

浏览器中输入localhost:8880,首次启动会让进入配置界面。完成后生成LocalSettings.php文件。也可以直接在这个配置文件中作配置。

生成的LocalSettings.php文件要拷到/data/wiki2目录下（配置文件中定义的卷挂载路径），并增加其r属性就可以了。

还记得在yml配置文件中数据库主机名是什么吧？database，对了，那么在配置中也要这样填写，如图：

五、wiki的使用技巧

1.左侧导航栏的配置
以管理员身份登录，在搜索栏中输入MediaWiki:sidebar
进入配置界面后就可以编辑了。比如：

navigation
    http://192.168.0.111:8880/index.php?title=Category:XXX|XXX
    mainpage|mainpage-description
    portal-url|portal 

3.分类
文章的末尾加入"category"标签即可将此文章放到了xxx分类中，一篇文章可以加入多个分类。
比如：[[category:XXX]]

4.新文章
在Search中输入你的文章名称即可Edit。

5.换行
用br标签可以换行。
空一行也会有换行效果。

6.pre标签包围源代码
例如：

private int mSize;

六、保存容器和导入

  sudo docker commit 9ab6e234c9ba linc-wiki  
    
  sudo docker images REPOSITORY               TAG                 IMAGE ID            CREATED             VIRTUAL SIZE linc-wiki                latest              b5a1e34b01c2        14 seconds ago      689.7 MB  
    
  sudo docker export 9ab6e234c9ba > /home/linc/docker/images-bk/linc-wiki-export.tar  
  sudo docker save linc-wiki > ../images-bk/linc-wiki-save.tar  
    
  $ du -sh *  
  495M    linc-wiki-export.tar  
  672M    linc-wiki-save.tar  
    
  sudo cat /home/linc/docker/images-bk/linc-wiki-export.tar | sudo docker import - docker_hgweb  
  sudo docker load --input ../images-bk/linc-wiki-save.tar  

附录：

1.fig使用报错及解决

fig running error:

  $ fig up  
  Couldn't connect to Docker daemon at http:/ - is it running?  
    
  If it's at a non-standard location, specify the URL with the DOCKER_HOST environment variable.  

fix it:

  1) Change the DOCKER_OPTS in /etc/default/docker to:  
  DOCKER_OPTS="-H tcp://127.0.0.1:4243 -H unix:///var/run/docker.sock"  
    
  2) Restart docker  
  sudo restart docker  
    
  3) Make sure that docker is running on localhost:4243   
  $ netstat -ant  |grep 4243  
  tcp        0      0 127.0.0.1:4243          0.0.0.0:*               LISTEN  
    
  4) Set DOCKER_HOST (.bashrc)  
  export DOCKER_HOST=tcp://localhost:4243  
    
  $ echo $DOCKER_HOST  
  tcp://localhost:4243   

参考：

dockerpool.com/static/books/docker_practice/fig/yml_ref.html