# osinstall-server

**Repository Path**: anjia/osinstall-server

## Basic Information

- **Project Name**: osinstall-server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-07-06
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 依赖
- MySQL（5.6+）
- Git
- Go1.11及以上版本
- gbb

## 安装
### 拉取源代码

``` shell
$ cd $YOUR_WORK_SPACE && git clone https://github.com/idcos/osinstall-server.git
```

### *nix下安装编译环境
1. 登录[golang官网](https://golang.org/dl/)或者[golang中国官方镜像](https://golang.google.cn/dl/)下载最新的稳定版本的go安装包并安装。

	```
	$ wget https://dl.google.com/go/go1.12.linux-amd64.tar.gz
	# 解压缩后go被安装在/usr/local/go
	$ sudo tar -xzv -f ./go1.12.linux-amd64.tar.gz -C /usr/local/
	```

1. 配置go环境变量

	``` shell
	$ vi ~/.bashrc
	export GOROOT=/usr/local/go
	export GOPATH=$GOPATH:$YOUR_WORK_SPACE/osinstall-server
	export PATH=$PATH:$GOROOT/bin
    $ source ~/.bashrc
	```

1. 安装[gbb](https://github.com/voidint/gbb)

	``` shell
	$ go get -u -v github.com/voidint/gbb
	```

如果以上工具都安装完毕，并且`$GOROOT/bin`和`$GOPATH/bin`都已经加入到`$PATH`环境变量下，那么执行操作后是否有类似输出👇

```
$ gbb version
gbb version 0.6.0
date: 2019-02-13T14:26:13+08:00
branch: master
commit: 1443991e7627e077dbf1c5ab86b3a2dff0216eb5
```

### 编译
进入源代码根目录后执行`gbb --debug`

``` shell
$ cd $YOUR_WORK_SPACE/osinstall-server && gbb --debug
```
编译完毕后，项目根目录`osinstall-server`下多了`bin`和`pkg`两个目录，其中`bin`目录下包含了多个可执行文件。

``` shell
$ ls -l bin
total 133848
-rwxr-xr-x  1 voidint  staff    10M  3  1 10:36 cloudboot-agent
-rwxr-xr-x  1 voidint  staff    10M  3  1 10:36 cloudboot-encrypt-generator
-rwxr-xr-x  1 voidint  staff   7.9M  3  1 10:36 cloudboot-initdb
-rwxr-xr-x  1 voidint  staff    16M  3  1 10:36 cloudboot-server
-rwxr-xr-x  1 voidint  staff    11M  3  1 10:36 pe-agent
-rwxr-xr-x  1 voidint  staff    11M  3  1 10:36 win-agent
```

查看编译得到的可执行文件的版本信息，可以看到编译的时间戳信息-`date`和源代码的版本信息-`commit`都已经烙印在了这个二进制可执行文件的版本信息中。这类信息对于`追溯`有重要作用。

``` shell
$ ./bin/cloudboot-server -v
cloudboot-server version 1.5.0
date: 2019-03-01T10:36:39+08:00
branch: master
commit: 3483d3a0a659510ba3fa63c440a92513c7aa2348
```

详情，请移步[gbb](https://github.com/voidint/gbb)。

### 初始化数据
1. 导入SQL文件初始化数据库
将`$osinstall_server/doc/db/cloudboot.sql`导入MySQL。

1. 配置文件`/etc/cloudboot-server/cloudboot-server.conf`

``` JSON
{
    "repo": {
        "connection": "root:mypassword@tcp(localhost:3306)/cloudboot?charset=utf8&parseTime=True&loc=Local"
    },
    "osInstall": {
        "httpPort": 8081,
        "pxeConfigDir": "/etc/osinstall-server/pxelinux.cfg"
    },
    "logger": {
        "logFile": "~/logs/osinstall.log",
        "level": "debug"
    },
    "vm": {
        "storage": "guest_images_lvm"
    },
    "rsa": {
        "publicKey": "/etc/cloudboot-server/rsa/public.pem",
        "privateKey": "/etc/cloudboot-server/rsa/private.pem"
    },
    "cron": {
        "installTimeout": 3600
    },
    "activeMQ": {
        "server": "activemq.dev.idcos.net:61614"
    },
    "device": {
        "maxBatchOperateNum": 5,
        "maxOperateNumIn5Minutes": 5
    }
}
```

## 运行

``` shell
$ cd $YOUR_WORK_SPACE/osinstall_server && ./bin/cloudboot-server -c /etc/cloudboot-server/cloudboot-server.conf
```



## 版权

Copyright 2019 Cloud J Tech, Inc and other contributors
Licensed under the GPLv3