使用 Docker 在服务器部署 CodiMD

本教程使用阿里云服务器学生机，系统为 CentOS 7，不同系统间方式大同小异。
之前一直习惯使用 HackMD，最近在进行数学建模比赛时需要文档协同编辑，由于众所周知的原因队友无法正常使用 HackMD，故在自己的服务器上部署 CodiMD，以确保可以无障碍访问。

一、CodiMD
CodiMD 是一个开源项目，可实现 MarkDown 文档的协同编辑，功能与 HackMD 一致（这好像是废话），项目地址在 GitHub 的 hackmdio 下，部署极为简单。适合无法正常使用 HackMD 的用户将其部署到自己的国内服务器，安全稳定。
二、安装前准备
CodiMD 默认监听 3000 端口，应提前设置阿里云安全组规则放行 3000 端口；若之前未开放 MySQL 的 3306 端口，这里也需要进行开放（原因在下文会讲）。

三、Docker 安装
Docker 是一个开放源代码软件，用于开发应用、交付应用、运行应用，这里使用其运行 CodiMD。Docker容器与虚拟机类似，但原理上，容器是将操作系统层虚拟化，虚拟机则是虚拟化硬件。
本文默认系统已经有 Git 环境。若没有，可执行 yum install git 安装。


安装 Docker
yum install docker



安装 Docker Compose
yum install docker-compose



四、安装配置 CodiMD


创建 MySQL 数据库
习惯了使用 MySQL ，这里也可使用其他数据库。
mysql -uroot -pbalabala#你的用户名与密码

mysql>create database codimd;

由于容器是从系统中分离出来的部分，其中运行的应用是对于系统来说位于系统外部，故直接访问 127.0.0.1 是无法访问本机的，需访问服务器的外网地址。因此，在 Docker 中运行的 CodiMD 无法直接通过 127.0.0.1:3306 访问 MySQL，需要将 MySQL 设置为所有 ip 均可访问：
mysql -uroot -pbalabala#你的用户名与密码

mysql>use mysql;
mysql>update user set host = '%' where user ='root';
mysql>select host, user from user;#查看是否修改成功
mysql>flush privileges;#使修改生效



配置 CodiMD
在某目录下（自定义）执行 vim docker-compose.yml （其实应当先创建再编辑，但 vim 会自动创建不参在的文件）编辑配置文件内容如下：
version: "3"
services:
  codimd:
    image: nabo.codimd.dev/hackmdio/hackmd:2.0.1
    environment:
      - CMD_DB_URL=mysql://root:balabala@39.97.235.0:3306//codimd
        # CMD_DB_URL 格式为 
        # 数据库连接协议://用户名:密码@数据库主机:数据库端口/数据库名
        # 如果同样使用 mysql，只需修改密码与服务器 ip 即可
      - CMD_USECDN=false
    ports:
      - "3000:3000"
    volumes:
      - upload-data:/home/hackmd/app/public/uploads
    restart: always
volumes:
  upload-data: {}

与上一步骤相同的原因，这里的 ip 必须使用外网 ip ，不能使用 127.0.0.1 。


安装 CodiMD
在上一步骤所在文件目录下执行如下语句即可依赖编辑好的配置文件完成 CodiMD 的安装：
docker-compose up -d



五、CodiMD 使用


基本使用
完成以上步骤，即可访问服务器的 3000 端口来到 CodiMD 主页（如下图）。注册登录后即可进行文档档创建与协同编辑。其他协作者可以放心大胆地使用，后台密码均进行了严格加密，密码防泄漏做得很好的。





注意事项
CodiMD 的注册界面跟登陆界面是同一个界面，及你注册跟登录的区别仅仅是在输入邮箱、密码后点击的按钮不同而已。由于不输入邮箱、密码 Register 按钮是无法按下的，就会给人一种没法注册的错觉。（都是习惯惹的祸）

感觉应当把这个注意事项放到前面一点的位置，防止大家再次踩坑，但总感觉放最后才符合文章的合理结构。

服务器部署-常用命令
前言
1、Linux服务器上部署jar包
shell脚本部署jar包

前言

真正在公司中的实践：NoSQL + RDBMS 一起使用才是最强的

技术没有高低之分，就看你如何去使用！（提升内功，思维的提高！多思考！）

云计算的长征之路：阿里云的这群疯子，阿里巴巴的架构演进！
1、Linux服务器上部署jar包
​

java命令部署jar包

java –jar XXXX.jar        （注意这个命令启动时，断开服务连接后，服务就关闭了）




setsid java -jar weekcp-boot-server-1.0.0.jar --server.port=8080  （如果是springboot的话。直接在application/yml指定端口运行）

setsid：切换到另一个进程运行 解决断开服务连接后服务就关闭的问题

查看运行中的java程序

ps -ef | grep java 查看运行中的java程序

杀死进程

​ kill -9 xxxx（进程号）

shell脚本部署jar包

ps  -aux | grep -i “weekcp” | grep -v grep | awk ‘{print $2}’ | xargs kill 9

setsid java -jar weekcp-1.0.0.jar

shell命令详解


ps aux                                                           是用BSD的格式来显示进程的


ps  -aux | grep -i “weekcp”                          过滤出含有weekcp的进程




grep -v grep                                               去除含有grep的进程




awk ‘{print $2}’ | xargs kill 9                       将前面获取到的进程号通过空格分割，传递给kill -9，杀死所有进程

文章目录
golang gin 服务器部署
前言
基本流程
1、build 项目
2、写执行脚本 run.sh
3、创建一个 service 配置文件
4、启动
5、配置反向代理和ssl证书

golang gin 服务器部署
前言
golang使用gin开发完毕后，切不可直接运行或者使用go run xxx.go这种形式，比较正规的做法是，利用linux的服务去管理，不然ssh一退出，网站就停止了。
基本流程
简略流程如下：

build出一个可执行文件
写一个sh文件，用来执行这个文件
配置service
启动
其他配置（反向代理、ssl证书等）

下面具体叙述
1、build 项目
我的项目中，主文件为main.go

执行：
go build main.go

则生成了一个新文件main

对其设置权限，这里用了777，因为有时候使用宝塔面板的时候，它的用户是www.
chmod 777 main

2、写执行脚本 run.sh
新建一个文件
vim run.sh

里面写这样的内容：
#!/bin/bash
# 设置为 release 生产模式
export GIN_MODE=release
# 切换到路径下，这样才能够使用和开发时候一样的相对路径
cd main文件所在的绝对路径
# 启动 build 后的可执行文件
./main

里面路径自行替换。

这里有两点需要注意的地方：

顶部的#!/bin/bash必不可少，如果少了这个，服务会无法启动。
使用先cd后执行的方式，可以让程序能够找到相对路径下的文件。

3、创建一个 service 配置文件
输入命令创建：
vim /lib/systemd/system/mpgo.service

其中mpgo为服务名称，以后启动都是这个名称。

里面写这样的内容：
[Unit]
Description=mpgo

[Service]
Type=simple
Restart=always
RestartSec=3s
ExecStart=run.sh文件的完整路径

[Install]
WantedBy=multi-user.target

路径需要自行替换

说明如下：

Description是对这个服务的描述
Restart=always服务异常退出时会重启
RestartSec=3s设置重启间隔为3秒
ExecStart=run.sh文件的完整路径这个服务会执行这个文件
WantedBy=multi-user.target所有用户都可以执行

4、启动
启动：
service mpgo start

重启：
service mpgo restart

停止：
service mpgo stop

状态：
service mpgo status

5、配置反向代理和ssl证书
这里推荐直接安装宝塔面板，里面有图形化界面操作。

步骤简略为：

反向代理：

新建静态网站 --> 绑定域名 --> 网站设置中的反向代理 --> 代理80端口到golang的端口
ssl证书

宝塔面板中可以一键申请。

Ubuntu PXE安装服务器部署

 

通过PXE自动进行服务器操作系统的安装是大规模服务器运维过程中的必要手段，本文档详细描述PXE服务器的部署和配置。

 

 

PXE自动服务器安装原理（以下内容来自互联网）

PXE(Pre-boot execution environment)是intel公司开发的一个技术，支持工作站从远程服务器上下载镜像，并由此启动操作系统。在启动过程中，终端请求分配IP地址，在使用TFTP协议下载一个启动软件包到本地内存中执行，最后由这个启动软件包完成终端基本软件的设置，从而完成操作系统的安装。

 

PXE的工作流程如下：



 

PXE服务器需要提供的服务

在通过PXE安装ubuntu操作系统时，PXE服务器需要提供如下4个服务

DHCP: dhcp服务用于在OS安装过程中进行IP地址的分配。

TFTP：TFTP服务用于OS安装过程中请求下载系统引导文件。

NFS：NFS服务用于OS安装过程请求下载内核镜像和对应配置文件。

HTTP：HTTP服务用于Ubuntu安装过程中请求软件包

 

 

DHCP服务安装和配置

DHCP服务用于向客户端动态分配IP地址。我们当前使用软件isc-dhcp-server提供DHCP服务。

安装：

在ununtu系统下，通过执行apt-get install isc-dhcp-server完成安装。

配置：

1：修改/etc/default/isc-dhcp-server配置文件，指定提供dhcp服务的网口

例如：通过本地ens38网口对外提供dhcp服务，在修改该文件，将INTERFACESv4和INTERFACESv6内容指定为ens38网口



 

2：修改/etc/dhcp/dhcpd.conf配置文件，指定动态分配IP地址时的IP地址端，下载的文件名称等信息。

修改dhcpd.conf文件中的 subnet配置域，如下是一个具体例子：



         配置参数说明：


			
filename
			
			

			
PXE引导启动文件名称，当前固定为 pxelinux.0
			
		

			
next-server
			
			

			
TFTP服务器地址（可以与DHCP服务共服务器部署，也可以分部署）
			
		

			
allow booting
			
			

			
允许在该段PXE
			
		

			
allow bootp
			
			

			
允许在该段PXE
			
		

			
range
			
			

			
描述分配的IP地址段
			
		

			
Option routers
			
			

			
描述的网关地址
			
		

			
Option subnet-mask
			
			

			
掩码
			
		

			
Option broadcast-address
			
			

			
广播地址
			
		
如果要根据MAC地址为服务器分配固定的IP地址，则需要打开host配置，样例如下：



 

 

TFTP服务安装和配置

TFTP服务用于在启动阶段向客户段提供引导文件，当前我们使用tftpd-hpa提供tftp服务

安装：

       在Ubuntu下通过如下命令安装tftpd-hpa服务。

       apt-get install tftpd-hpa

配置：

         修改/etc/default/tftpd-hpa文件，修改tftp服务指定的根目录，配置样例如下：

       

 

nfs服务安装和配置

NFS服务可以提供给安装阶段下载内核文件

安装：

在ubuntu下通过如下方式安装nfs服务。

         apt get-install nfs-kernel-server

配置：

         修改/etc/exports文件，为nfs指定服务根目录，配置样例如下：



HTTP服务的安装和配置

         在软件包安装过程中，http为Ubuntu提供软件源服务。在这里，我们使用apache提供http服务。

安装：

         执行apt-get install apache2进行安装。

配置：

         安装完成后，修改/etc/apache2/sites-available/000-default.conf文件，为其指定http服务根目录，配置样例如下：

         

         注意配置文件中的 DocumentRoot项和Directory标签，这两个位置与后面OS安装相关，详细信息后面说明。

 

被安装OS文件准备

我们从标准的ubuntu ISO镜像文件中获取系统安装的文件。

1：使用mount命令挂载Ubuntu ISO镜像文件，这里以ubuntu Server版本为例子，将ISO镜像文件挂载到1604目录

         mount -t iso9660 ubuntu-16.04.5-server-amd64.iso 1604

2：为TFTP根目录准备安装引导文件

         TFTP根目录需要包含以下内容

         

         其中pxelinux.cfg是一个目录，包括内容如下：

         

         从挂载1604/install/netboot/ubuntu-installer/amd64目录下拷贝pxelinux.0到tftp服务根目录/opt/tftp

         从挂载1604/install/netboot/ubuntu-installer/amd64/boot-screens目录下拷贝ldlinux.c32，libcom32.c32，libutil.c32，vesamenu.c32文件到tftp服务根目录/opt/tftp

         在tftp服务根目录/opt/tftp目录下创建pxelinux.cfg目录,并在该目录下创建配置文件default和 pxe.conf（当前文件内容为空，后面章节补充内容）

 

3：在PXE安装OS过程中，需要通过NFS或HTTP服务下载内核映像文件到客户端服务器，因此我们在tftp服务根目录下创建一个OS安装目录，以组织不同的OS安装文件（这样，tftp在访问时也可以通过相对路径进行访问）

在tftp根目录/opt/tftp目录下创建目录OSInstall用来保存我们所有可能的OS信息。
         对于安装ubuntu系统，我们在OSInstall目录下创建子级目录ubuntu用于保存安装文件。

         考虑到ubuntu还有不同的发现版本，因此可以在ubuntu目录下在创建版本目录，比如说16.04表示Ubuntu 16.04的安装文件所在目录。

         目录结构如下（该目录根据具体要求创建，无特殊要求）

         

        

拷贝ubunt ISO挂载目录下的所有文件到 OSInstall/ubuntu/16.04目录


                   注意：由于cp拷贝的时候使用通配*无法将.disk拷贝到目的目录，因此需要单独拷贝一次.disk目录内容。

修改nfs服务配置，将/opt/tftp/OSInstall目录共享出去
修改/etc/exports文件，将nfs的共享根目录修改为/opt/tftp/OSInstall



         4）修改http服务配置，将/opt/tftp/OSInstall目录设置为http服务根目录



4：准备自动化安装配置文件ks.cfg

         在安装系统过程中，当系统提示选择语言，键盘等信息时，如果不想人工操作，则可以通过该配置文件交由系统自动完成。该文件是一个文本文件，其内容如下：



编辑完成该文件后，考虑到不同的操作系选择不一样，因此建议将该文件拷贝到具体操作系统目录下，例如拷贝到OSInstall/ubuntu/16.04/目录



 

 

配置文件编写

在PXE安装过程中，需要编写的配置文件主要包括3个，即tftp根目录下的pxelinux.cfg子目录内的default和pxe.conf文件，

其中pxe.conf文件描述引导启动过程中启动菜单选项。Default文件描述启动引导启动使用的文件信息。

此外还有一个文件ks.cfg用于描述系统安装过程中的自动响应，该文件我们放置于每个操作系统文件的根目录下。

pxe.conf文件内容：

MENU TITLE PXE Server

NOESCAPE 1

ALOWOPTIONS 1

PROMPT 0

MENU WIDTH 80

MENU ROWS 14

MENU TABMSGROW 24

MENU MARGIN 10

MENU COLOR border 30;44 #ffffffff $00000000 std

 

Default文件内容如下：

DEFAULT vesamenu.c32

TIMEOUT 20

PROMPT 0

MENU INCLUDE pxelinux.cfg/pxe.conf

NOESCAPE 1

LABEL Install Ubuntu 16.04 Server

MENU LABEL Install Ubuntu 16.04 Server

kernel OSInstall/ubuntu/16.04/install/vmlinuz

append boot=install automatic-ubiquity netboot=nfs nfsroot=172.17.1.12:/opt/tftp/OSInstall initrd=OSInstall/ubuntu/16.04/install/netboot/ubuntu-installer/amd64/initrd.gz live-installer/net-image=OSInstall/ubuntu/16.04/install/filesystem.squashfs quit

ENDTEXT

 

 

ks.cfg文件内容如下：

 

auth --useshadow --enablemd5

bootloader --location=mbr

clearpart --all --initlabel

firewall --disable

install

keyboard us

lang en_US

langsupport en_US

logvol swap --vgname=sdn_vg --name=lv_swap --size=2048

logvol / --vgname=sdn_vg --fstype ext4 --size=1 --grow --name=lv_root

mouse

network --bootproto=dhcp --nameserver=172.17.1.12 --noipv6 --activate --device=eth0 --onboot=on

openssh-server

%packages

part /boot --fstype ext2 --size 500

part pv.01 --size=1 --grow

reboot

rootpw --disabled

text

timezone Asia/Shanghai

url --url http://172.17.1.12/ubuntu/16.04/

user test --fullname "test" --iscrypted --password --plaintext --password test123

volgroup sdn_vg pv.01

zerombr yes