README

“欢迎，罗卡南，我的客人。告诉我你为何向南行。”

“我前往寻找我的敌人，女士。我希望进入他们的……他们的城堡，并利用他们的……信使，告诉联盟他们在这里。”

—— “罗卡南的世界”，厄休拉·K·勒古恩

罗卡南是一个工具，旨在简化跨团队的标准开发环境配置。它实际上是 Vagrant 的包装器，正如其同名人可能暗示的那样，也是 Ansible。

先决条件

PHP 7.1.3
Composer

安装

使用以下命令将 Rokanan 安装到您的项目中

composer require --dev fostermadeco/rokanan dev-master --ignore-platform-reqs

为了便于调用本地安装的 rokanan，请在您的 PATH 中将 ./vendor/bin 预先添加。

注意：不再支持全局安装。

关于 Homebrew 的说明

由于 Homebrew/php 今年早些时候已被弃用并迁移到 Homebrew Core，如果您自 3 月份以来对通过 brew 安装的 PHP 做了任何更改，您可能也会在主机机器上遇到 PHP 的不一致性或意外行为。根据您的判断，彻底卸载 Homebrew 并重新安装可能是明智的——我们中有很多人这样做而没有产生不良影响。

如果您卸载了它，您可能还想按照卸载程序的提示，删除卸载程序在完成后列出的任何或所有非空目录。唯一的例外是 /usr/local/etc，除非您在 /usr/local/etc/ssl/certs 中没有存储任何自签名证书。

关于 GNU coreutils 的说明

如果您通过 Homebrew（或其他方式）安装了 GNU coreutils，您可能会偶尔看到以下警告

stty: standard input: unable to perform all requested operations

您可以安全地忽略它。如果它真正让您烦恼，请选择您的 PATH 中具有优先级高于 /usr/local/opt/coreutils/libexec/gnubin 的文件夹。在那个文件夹中，创建一个指向 /bin/stty 的符号链接。

功能

在罗卡南仍然处于测试版时，其主要功能是提供对自定义 Ansible 角色访问，这样我们就可以避免将它们作为 Git 子模块包含在项目中带来的混乱和复杂性。

还有一些可以在测试版中运行的命令——我们欢迎并希望得到您对它们功能的反馈！

`rokanan init`

这将帮助您交互式地初始化项目。

`rokanan trust-cert`

在运行 vagrant up 后运行此命令，以自动信任自签名证书（仅支持 macOS）。

`rokanan check`

这将报告您的系统是否已针对与Rokanan一起使用进行了优化。

`rokanan connect`

这实际上是对 vagrant ssh 的封装。所有封装的vagrant命令都会自动设置 VAGRANT_USE_VAGRANT_TRIGGERS=1 环境变量，以抑制关于vagrant-triggers插件与核心功能相关的2.1+警告。

`rokanan run [子命令]`

这将在一个已配置的虚拟机内部运行命令，而不会创建会话。命令将在项目目录（/var/www/{{ hostname }}）中运行。

fostermadeco / rokanan

维护者

详细信息