ambientum/node

Ambientum

在开发、staging和生产环境之间保持一致性往往并非易事。近年来，Docker逐渐成熟并成为行业标准。我们都喜爱Laravel和Vue.JS，但为何要用出色的框架开发优质代码时，却没有一个理想的环境呢？告别"在我机器上能运行"的问题！

核心功能与特性

Ambientum可帮助实现以下主要场景：

• 在开发环境中运行Laravel和/或Vue.JS
• 在生产环境中运行Laravel和/或Vue.JS（含持续集成支持）
• 使用Docker命令替换本地依赖

使用前须知

开始使用Ambientum前，需具备以下知识：

替换本地命令需知：

• Docker和容器的基础知识
• 熟悉命令行操作

运行Laravel或Vue.JS开发环境需知：

• 掌握docker-compose的使用方法

注意事项

Docker自带的docker-compose通常版本较旧。请从Github安装最新版本：https://github.com/docker/compose/releases%E3%80%82

镜像信息

若已熟悉相关工具并了解Ambientum，以下是可用镜像集合，可用于构建所需环境：

快速使用指南

替换本地命令

Ambientum的功能之一是允许使用基于Docker的版本替换（通常难以安装的）命令。通过一组别名可实现此功能，需先安装并激活这些别名：

Bash和ZSH用户：

bash
curl -L https://github.com/ambientum/ambientum/raw/master/commands.bash -o ~/.ambientum_rc
source ~/.ambientum_rc

Fish用户：

bash
curl -L https://github.com/ambientum/ambientum/raw/master/commands.fish -o ~/.ambientum_rc
source ~/.ambientum_rc

Windows用户（通过Git Bash）：

其他Windows控制台（如PowerShell或Cmder）请查看此https://github.com/julihermes/ambientum-commands-for-windows%E3%80%82

bash
curl https://github.com/ambientum/ambientum/raw/master/commands.git-bash -o ~/.ambientum_rc
source ~/.ambientum_rc

激活命令后即可立即使用。

注意：首次执行可能需要一些时间，因为会下载镜像

所有Node.JS相关命令可通过前缀n执行。例如安装Gulp：

bash
n npm install -g gulp
n gulp --version

所有PHP相关命令可通过前缀p执行。例如运行composer：

bash
p composer global require some/package-here

或运行单个PHP文件：

bash
p php test.php

创建新Laravel项目示例：

bash
p composer create laravel/laravel my-project-name-here

运行现有项目

若已有项目，可通过定义docker-compose.yml文件来公开和运行所需服务。

建议了解docker-compose工具以便使用以下配置文件

Laravel项目的docker-compose.yml

yml
####
# 注意：
# 将所有"sandbox"替换为你的项目名称
####

# v2语法
version: '2'

# 命名卷
volumes:
  # Postgres数据
  sandbox-postgres-data:
    driver: local

  # MySQL数据
  sandbox-mysql-data:
    driver: local

  # Redis数据
  sandbox-redis-data:
    driver: local

services:
  # Postgres (10.3)
  postgres:
    image: docker.xuanyuan.run/postgres:10.3
    container_name: sandbox-postgres
    volumes:
      - sandbox-postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_PASSWORD=sandbox
      - POSTGRES_DB=sandbox
      - POSTGRES_USER=sandbox

  # MySQL (5.7)
  mysql:
    image: docker.xuanyuan.run/mysql:5.7
    container_name: sandbox-mysql
    volumes:
      - sandbox-mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=sandbox
      - MYSQL_DATABASE=sandbox
      - MYSQL_USER=sandbox
      - MYSQL_PASSWORD=sandbox

  # Redis
  cache:
    image: docker.xuanyuan.run/redis:4.0
    container_name: sandbox-redis
    command: --appendonly yes
    volumes:
      - sandbox-redis-data:/data
    ports:
      - "6379:6379"

  # PHP（带Nginx）
  # 可将"image"改为apache使用Apache服务器
  app:
    image: docker.xuanyuan.run/ambientum/php:7.2-nginx
    container_name: sandbox-app
    volumes:
      - .:/var/www/app
    ports:
      - "80:8080"
    links:
      - postgres
      - mysql
      - cache

  # Laravel队列
  queue:
    image: docker.xuanyuan.run/ambientum/php:7.2
    container_name: sandbox-queue
    command: php artisan queue:listen
    volumes:
      - .:/var/www/app
    links:
      - mysql
      - cache

Vue.js项目的docker-compose.yml

开发Vue.js项目？以下是对应的docker-compose配置：

yml
version: '2'

services:
  # Web服务器 - 用于热重载和开发
  # 此环境也可用于运行npm和node命令
  dev:
    image: ambientum/node:9
    container_name: sandbox-vue-dev
    command: npm run dev
    volumes:
      - .:/var/www/app
    ports:
      - 8080:8080

  # 在"真实"服务器上测试dist目录
  production-server:
    image: nginx:stable-alpine
    container_name: sandbox-preview-server
    volumes:
      - ./dist:/usr/share/nginx/html
    ports:
      - 9090:80