Awesome

Centstead

这是一个 PHP 调试环境 , 基于 centos,laravel/homestead.

介绍

　　基于开发的实际需求,PHP开发者通常需要一个贴近生产环境,又易于维护的测试与开发环境.以往的选择:

xampp, wamp, phpstudy… 集成环境，启动方便，占用小，但是需要往往不能提供 curl,pgsql,imagick… 插件, 自行编译成本很高。
基于虚拟机手工搭建一个linux环境，然而虚拟机的初始化过程却相当费时费力。

　　似乎易用与贴近生产环境很难平衡。然而 Vagrant 的到来为我们提供了这种可能. Vagrant 提供了一个便捷的方式来管理和设置虚拟机。Vagrant 提出了盒子的概念. 一个盒子即是一个初始化过的虚拟系统, 需要的时候可以基于盒子快速生成虚拟机, 出现错误时又可以在几分钟之内快速销毁重建。

　　Centstead 就是一个高度定制的 CentOS + php 盒子, 你可以通过 Centstead 提供的脚本与 vagrant 命令方便的管理你的虚拟环境。

Centstead 预置软件： (可基于配置快速切换版本)

CentOS 7
PHP 5.4 / 5.5 / 5.6 / 7.0
Mysql 5.5 / 5.6 / 5.7
MariaDB 5.5 / 10 / 10.1
PostgreSQL 9.2 / 9.3 / 9.4 / 9.5
Composer
Nginx
Redis
Sqllite3
Supervisor
Xdebug
Nodejs (npm webpack gulp bower)
memcached
Beanstalkd

#文档

开始

基础配置

共享文件夹

Nginx 网站配置

定制环境软件

文件拷贝

计划任务

Laravel 队列监听

数据库自动创建

SSH连接/管理虚拟环境

自定义虚拟环境

附录

Vagrant 介绍/技巧

团队配合

Fuck GFW

参与捉虫

安装 & 设置

一、首次安装

　　在使用 Centstead 之前，需要先安装 Virtual Box 和 Vagrant, 它们都提供 windows, mac ,linux 系统的安装程序。

二、安装 Centstead Vagrant 盒子

　　VirtualBox 和 Vagrant 安装好了之后, 接着下载 Centstead 盒子, Centstead 默认提供了两个版本的盒子,供自行选择 :

先锋版 virtualbox_avant.box ,预制 php 7.0 mysql 5.7
通用版 virtualbox_usual.box ,预制 php 5.6 mysql 5.6

1. 从 Vagrant 官方镜像安装

命令:

vagrant box add jason-chang/centstead-avant
#或者
vagrant box add jason-chang/centstead-usual

2. 从网盘下载安装

下载地址:　百度网盘

下载完成后, cd 到 .box 所在目录, 执行命令将 box 添加到 Vagrant 环境.

cd downlods/path
vagrant box add ./avant.box --name=jason-chang/centstead-avant
或者
vagrant box add ./usual.box --name=jason-chang/centstead-usual

注意

网盘下载安装盒子的同学，在初始化后一定要修改config/config.yml文件，去掉 #version: ">=0" 行前的注释#。 (因为vagrant离线形式安装盒子无法定义版本信息，如不开启此项,，vagrant校验版本后依然会从官方源下载盒子.)

三、通过 GitHub 克隆 Centstead

box 安装完成后, 克隆 Centstead 代码库到任意目录.

cd some/directory
git clone https://github.com/jason-chang/centstead.git centstead

<h4 id="init-config"> 四、初始化配置文件 </h4>

克隆完成后,cd 到 centstead 目录下运行 init.sh / init.bat 执行初始化操作.

如果你使用 mac 或 linux，请执行 bash init.sh
如果你使用 windows，请执行 init.bat

初始化过程将在 centstead 目录中创建 config 文件夹，config 文件夹下包含两个文件:

config.yaml <br> 主配置文件，几乎所有 censtead 配置工作都是通过修改 config.yaml 实现。文件格式上它遵循 yaml 标准. <br> after.sh <br> vagrant provision 完成后的钩子文件，可以用来执行自定义虚拟环境操作。 <br>

提示:

执行 init 脚本过程中需要安装部分 vagrant 插件，安装过程可能因为 GFW 原因安装失败请 <a href="#set-proxy">为 bash / cmd 设置代理</a>.

至此使用 centstead 的脚手架工作都完成了, 然后:

根据盒子版本在**基础配置** 设置 box 字段和 version 字段 ,
根据你的项目目录 配置共享文件夹 ,
根据你的项目域名 设置 nginx 站点,
启动 Vagrantbox 就可以享受 centstead 的福利了.

五、启动 Vagrant Box

配置好 config/config.yaml 文件后, 在 Centstead 目录下运行 vagrant up 命令, vagrant 将会启动虚拟机、配置共享文件夹、以及 Nginx 站点(并且写入主机的hosts).

然后,访问你设置的域名开始调试 php 程序吧!

销毁该机器，可以使用 vagrant destroy

为了更好的使用 centstead 请阅读 Vagrant 介绍

推荐:

同时推荐各位 , 使用支持 windows 和 mac 的 GUI 工具 vagrant-manager , 管理你的 Vagrant 虚拟机.

windows 版本

mac 版本

配置参数:

ip: 　　　　虚拟机 ip <br> memory: 　　虚拟机内存 <br> cpus: 　　　虚拟机 cpu 核心数 <br> provider: 　　虚拟机容器.(Vagrant 默认可以提供多种虚拟机容器, 包括 Vmware 和 VirtualBox, 但是 Vmware 支持是付费的, 本人无米暂时只能支持 VirtualBox) <br> box: 　　　　基础盒子名称 <br> version: 　　基础盒子版本, 此项默认关闭/注释, 离线安装盒子的用户请开启。 <br>

示例:

ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox
box: jason-chang/centstead-usual
#version: ">=0"

<h1 id="share-folder">共享文件夹</h1>

　　config.yaml 文件中的 folders 属性列出了所有主机和 Centstead 虚拟机共享的文件夹，一旦这些目录中的文件有了修改，将会在本地和 Centstead 虚拟机之间保持同步，如果有需要的话，你可以配置多个共享文件夹（一般一个就够了）：

配置参数:

map: 主机文件目录 <br> to: 映射到虚拟机的目录 <br> type: 同步类型: 1.默认为空表示使用 shareFolder. 2. nfs （推荐）表示使用 nfs 同步.

示例:

folders:
  - map: ~/Projects
    to: /home/vagrant/Projects

如果要开启 NFS，只需简单添加一个标识到同步文件夹配置，如下:

folders:
  - map: ~/Projects
    to: /home/vagrant/Projects
    type: nfs

<h1 id="sites-config">Nginx 网站配置</h1>

　　对 Nginx 不熟？没问题，通过 sites 属性你可以方便地将“域名”映射到 Centstead 虚拟机的指定目录，config.yaml 中默认已经配置了一个示例站点。和共享文件夹一样，你也可以配置多个站点。（不同于 homestead, Centstead 的站点是基于项目的, 每个项目支持多个子站点）

配置参数:

conf:　　　项目最终保存成的配置文件 <br> servers:　　项目包含的域名 servers <br> map:　　　支持的域名 server name 多个域名可以空格分隔. <br> to：　　　指向的项目根入口目录. <br> type:　　　站点类型, 支持的配置值: <br>

不设置/default(普通php站index.php为入口) <br>

static (静态文件站) <br>

proxy (反向代理站) <br>

laravel (项目网站) <br>

thinkphp (thinkphp网站) <br>

symfony (symfony2网站) <br>

port：　　　http 监听端口 <br> ssl: 　　　　https 监听端口 <br> aliases：　　所有在 centstead 中配置的站点 centstead 将智能的加入主机的 hosts 文件中, 这样当 vagrant 启动完成的时候后，可以直接浏览配置的域名了。

centstead 默认取 map 值加入 hosts 文件，但是由于 hosts 文件并不是非常强大, 类似 **.demo.app 的泛解析域名将不能支持, aliases 就是为此提供的自定义接口, 如果配置存在 aliases 则抓取 aliases 加入 hosts 文件

示例:

sites:
  - conf: demo.app
    servers:
      - map: static.demo.app
        to: /home/vagrant/Projects/Demo/static
        type: static

      - map: "demo.app *.demo.app"
        to: /home/vagrant/Projects/Demo
        aliases: "demo.app a.demo.app u.demo.app www.demo.app"
        # port: 80
        # ssl: 443

默认情况下，每个站点都可以通过 HTTP（端口号：8000）和 HTTPS（端口号：44300）进行访问.

提示:

配置完成后, 执行 vagrant up 就可以通过浏览器调试指定的网站了.如果是已经启动过的环境请执行 vagrant provision 应用新的站点配置.

<h1 id="environment-soft">定制环境软件</h1>

　　为了更加贴近实际的生产环境, 我们往往需要配置特定的 php, mysql, postgre 版本. centstead 为此提供了非常简便的配置支持.

注意:

编辑 config.yaml 后别忘了执行 vagrant provision 使配置生效。

PHP版本切换

通过 php: 配置实现支持的值: php54, php55, php56 php70 对应不同 php 版本.

示例:

php: php70

提示:

Centstead 已经默认配置好所有 php 版本的 xdebug 支持，只需要配合 xdebug helper + phpstorm/eclipse …… 远程调试 php 了。(默认调用调试端口 9000)

所有 php 版本均默认安装了, redis, memcached, postgre, mysql, gd, imgick, mbstring, mcrypt, curl, openssl, xdebug 插件, 但是如果你还需要安装 yar 呢怎么办, 去自定义虚拟环境看看.

Mysql/MariaDB版本切换

通过 mysql: 配置实现支持的值: mysql55, mysql56, mysql57, mariadb55, mariadb10, mariadb101 对应不同 Mysql/MariaDB 版本.

示例:

mysql: mariadb101

提示:

Centstead 已经默认将主机的 33060 端口映射到虚拟主机的 3306 端口。并且预置了一个权限与 root 相同的 mysql 用户，用户名：vagrant 密码: vagrant。故此可以通过 vagrant 用户连接 localhost:33060 管理虚拟环境的 Mysql/MariaDB 数据库。

PostgreSql版本切换

通过 pgsql: 配置实现支持的值 pgsql92, pgsql93, pgsql94, pgsql95, 对应不同 PostgreSql 版本.

示例:

pgsql: pgsql95

提示:

虽然国内使用 postgre 的用户越来越多, 但是始终不如 mysql , 所以默认盒子并没有安装 postgre <br> 但是配置此值稍等几分, PostgreSql 就配置好了 <br> <br> Centstead 已经默认将主机的 54320 端口映射到虚拟主机的 5432 端口. <br> 并且添加了权限与 root 相同的 postgre 用户, 用户名：vagrant 密码: vagrant. <br> 故此可以通过 vagrant 用户连接 localhost:54320 管理虚拟机 PostgreSql 数据库. <br>

初始化过程中我们可能想要将部分文件拷贝到虚拟环境, 配置可以参考如下

配置参数:

from:　文件所在目录 <br> to:　　拷贝到虚拟机的目录

示例：

copy:
  - from: ~/copy.demo
    to: /home/vagrant/copy.demo

提示:

拷贝文件支持目录和文件，但是不支持覆盖，如果要同步修改，请使用共享文件夹配置.

无论测试环境还是生产环境，我们都可能执行一些长期/定期轮训的任务, 通过 centstead 你可以方便的创建 crond 任务.

配置参数:

name: 任务名称 <br> user：任务执行的用户 <br> interval: 任务的执行频率 <br> command: 任务的执行命令

示例：

schedules:
  - name: redis_demo
    user: vagrant
    interval: "* 0 */1 * *"
    command: "/usr/bin/redis-cli -h localhost DEL 'some-throttle'"

<h1 id="queues">Laravel 队列监听</h1>

如果你是一名 Laravel 开发者这里提供了一个便捷的方式创建, Laravel 队列监听。

配置参数:

name: supervisor任务名称 <br> driver：队列的驱动 <br> queue: 队列名称 <br> dir: 项目artisan所在目录

示例：

queues:
  - name: demo.app.mails
    driver: redis
    queue: emails
    dir: /home/vagrant/Code/Demo

重要提示：

由于 vagrant 共享文件夹的挂载晚于 linux supervisor 系统服务, 每次 vagrant halt 重启虚拟机后, 可能发现队列监听失效了. <br> 请等待共享文件夹挂载完毕后，连入 SSH, 然后执行 sudo systemctl restart supervisord.service 重启队列监听. <br> 然后可以通过 ps aux | grep artisan 命令验证队列监听是否在工作。

<h1 id="create-database">数据库自动创建</h1>

通常我们可能希望为不同的项目, 创建不同的虚拟机环境, 那么为什么不在虚拟机配置时自动生成相应数据库呢？

配置参数:

db: 数据库所在容器, 默认mysql.

示例：

databases:
	- name: vagrant
    - name: vagrant
      db: pgsql

注意:

postgre 用户再启动过程中可能会发现如下错误，请忽略: could not change directory to "/home/vagrant": 权限不够

<h1 id="ssh">SSH连接/管理虚拟环境</h1>

连接 SSH

Centstead 已经默认将主机的 2222 端口映射到虚拟机的 22 端口，所以你可以 ssh://vagrant:vagrant@127.0.0.1:2222 连接虚拟环境

Vagrant 用户

Centstead 默认添加了权限与 root 相同的 linux 用户，用户名：vagrant 密码: vagrant 故此可以通过 vagrant 用户连接 localhost:2222 管理虚拟机，另外由于 vagrant 具有完全的 sudo 权限, 如果你需要执行一个 root 权限的操作, 可以参考如下

sudo yum install php-yar

切换到 root 用户

你可以使用 vagrant 用户登录，输入 su -，然后输入密码: vagrant 切换到 root 用户。
Centstead 默认修改内置的 root 用户密码为 vagrant, 可以直接使用密码 vagtant 连接 root 用户。

公钥认证

如果你配置了 authorize: 类似如下

authorize: ~/.ssh/id_rsa.pub

则可以通过公钥认证，连接vagrant用户。

私钥导入虚拟环境

大多数情况下，我们的开发工作会是在实机环境，但是偶尔还是会在虚拟环境执行一些， github 或者 gitlab 的 pull/push 操作.

为虚拟机单独生成并导入一个秘钥？ NO

配置 keys: 就好了, Centstead 就会将指定的私钥文件导入到虚拟环境。

keys:
  - ~/.ssh/id_rsa

<h1 id="customize">自定义虚拟环境</h1>

没有任何一个软件, 能够完全满足定制化的需求。

如果我们的虚拟环境, 需要其他的运行时软件, 或者 php 插件怎么办？ Centstead 为这种需求提供了一个钩子文件,就是 config.yaml 同级目录下的 after.sh 文件.

每次 vagrant provision 执行的最后都会执行这个钩子.

例如安装 yar 的需求，我们就可以编辑 after.sh 如下:

#!/bin/sh

# 安装 yar 插件
yum install php-yar
systemctl restart php-fpm.service

<h1>附录</h1> <h1 id="vagrant">Vagrant 介绍</h1>

Vagrant 一个环境部署的脚手架工具, 在实际的应用中, 它可以支持 aws-ec2 docker …… 众多的类容器环境的部署. 然而本应用中直接把 vagrant 视作管理 Vmware/VirtualBox…… 多种虚拟环境的统一接口.

Vagrant 常用命令

vagrant up
# 初始化并且启动一个虚拟环境（初次执行 up 操作时会附带执行 provision 操作，以后将不会）

vagrant halt
# 关闭虚拟环境

vagrant provision
# 对虚拟环境重新执行初始化操作.
# Centstead 的 "创建nginx 站点"，"定制环境软件"，"共享文件夹"， "拷贝文件"， "自定义虚拟环境"， "计划任务创建"都是在这一层执行.
# 所以如果对上述内容修改以后都要执行 `vagrant provision` 应用更改.

vagrant suspend
# 暂停/休眠虚拟环境

vagrant resume
# 恢复虚拟环境

vagtant destroy
# 摧毁虚拟环境

Awesome

Centstead

介绍

Centstead 预置软件： (可基于配置快速切换版本)

附录

安装 & 设置

一、 首次安装

二、安装 Centstead Vagrant 盒子

1. 从 Vagrant 官方镜像安装

2. 从网盘下载安装

三、通过 GitHub 克隆 Centstead

五、启动 Vagrant Box

PHP版本切换

Mysql/MariaDB版本切换

PostgreSql版本切换

Vagrant 常用命令

更多内容请看 官方文档

一、首次安装

更多内容请看官方文档