• 如果感觉此篇过于冗长, 自己的技术较高, 请参阅极简英文指导, 方法与此文不同. Windows + Cygwin
• 如果部署时有错误，自己Google后，仍无法解决，请在Issues提问.
• Issues中有提问的模板. 但再强调一下，如果是了解APJP的原理方面，提建议或反馈Bug，尽量用English，如果仅是部署遇到无法解决的问题，请详细描述你的问题，越想详细，越快解决的你的问题的，中文即可.
• 至于OpenShift的优缺点，需要点时间，才能补上，同时期待各位反馈

OpenShift平台使用指导

以Windows 7为例，Linux / Mac上参考此文自己探索，实质上是以Fedora_16为例

VirtualBox中创建Fedora_16

1.下载安装VirtualBox和下载Fedora_16

VirtualBox官网下载地址:VirtualBox 4.1.8 for Windows hosts -> x86/amd64 点击即下载

Windows上安装VirtualBox，默认设置就可，即双击安装文件，一路Next

• VirtualBox官网

Fedora_16官方下载地址:Fedora-16-i386-DVD.iso 点击即下载

2.VirtualBox新建虚拟机

VirtualBox的主页面，点击“新建”，这时 VirtualBox 会运行 向导工具，帮助建立虚拟机，单击下一步

如果你有2G及以上的内存，推荐的768MB，就可，也是Fedora官方要求的最低配额。实际少点也可，但性能上会有许多折扣，不影响部署APJP

硬盘格式随意，图中只是个人喜欢的配置

3.安装Fedora_16

VirtualBox的主页面，选中“Fedora_16”，单击菜单栏的“开始”，启动首次运行向导

余下内容参见，实体机安裝 Fedora 16 (Verne)，和VirtualBox中装区别不大。另可参见，VirtualBox中 安装 Fedora16，无视此文中”Configure Network” 设置网络部分，使用NAT就可。

• 注意”软件选择”: 选”软件开发 (Software Development)”，其他的默认设置即可。
• “Creater Use” 注意”Add to Administrators group”

4.安装增强功能

• 注意上图的红色字”FAILED”, 如果安装正确是没有的，要全部青绿色的”OK”，如下图。

重启Fedora_16，创建安装完成

5.Windows7 （Host System） 与 Fedora_16 共享文件，演示 需成功安装增强功能

sudo mount -t vboxsf E_DRIVE ~/Downloads # 注意随机应变

OpenShift简介

http://en.wikipedia.org/wiki/Red_Hat#OpenShift

创建帐号

到 https://openshift.redhat.com/app/user/new/express 注册帐号。过程简单，在此省略。缩短篇幅。用Gmail只需2分钟，其他邮箱未知

安装客户端工具

以Fodera_16为例，其他平台自行参考https://openshift.redhat.com/app/express#quickstart

1.文件openshift.repo 点击即官网下载，存放路径: ~/Downloads/ （即/home/user/Downloads/）

2.将openshift.repo 文件，移至 /etc/yum.repos.d/ 文件夹内

打开”Ternimal”,执行以下指令

$ sudo mv ~/Downloads/openshift.repo /etc/yum.repos.d/

3.安装客户端工具 (有可能因为mirror的问题，失败！重复执行此命令直至最后出现”Complete!” 第一次安装，执行四次成功！演示这次，一次成功！均无VPN情况下）

$ sudo yum install rhc

文件

• http://apjp.googlecode.com/files/APJP_KEY-0.1.0.zip
• http://apjp.googlecode.com/files/APJP_LOCAL-0.9.2.zip
• http://apjp.googlecode.com/files/APJP_REMOTE_DOTCLOUD-0.1.1.zip

生成Key

转到APJP_KEY目录，Fedora_16 上运行APJP_KEY.sh，会显示一个APJP的密钥，类似APJP_KEY=FkPMd40j6vzfsEbf

编辑ROOT.war中的APJP.properties

下载APJP_REMOTE_DOTCLOUD最新版本,解开压缩文件,转到APJP_REMOTE_DOTCLOUD目录
目录內有ROOT.war文件，解开

在当前目录释放文件，并进入ROOT文件夹得到index.html, META-INF和WEB-INF两个目录

转到WEB-INF目录,编辑APJP.properties的KEY栏位,KEY可往项目下载栏下载产生KEY的程序

完成後存档，可把原来的ROOT.war和Readme.txt删除,将index.html, META-INF和WEB-INF两个目录
压缩为ROOT.zip ,然後改名为ROOT.war 。只有现在的ROOT.war有用

上传App

Fedora_16 中打开”Terminal”执行以下指令

1.创建域名

$ rhc-create-domain -n <YOUR-DOMAIN> -l <YOUR-USERNAME> -p <YOUR-PASSWORD> # 部署新应用跳过此步

• “Invalid user credentials” “无效的用户凭据”, 第一次帐号密码输入错误 :) 只好执行第二次, 细心的朋友能看到两次的执行的代码的不同吧?

1. 除了输入错帐号, 第一次另外还生成了SSH密钥的, 第二次就直接创建域名的
2. “-p 密码” 如果不一起执行, 就会出现询问的密码的,此时输入密码不显示. 一起执行时, 密码是明文显示的, 参见下图中红色遮盖
3. 第一次执行,生成SSH密钥时,会询问是否创建SSH密钥的密码, 直接”Enter”为无密码,强烈建议创建密码

2.创建App

$ rhc-create-app -a <YOUR-APPLICATION> -t jbossas-7.0 -p <YOUR-PASSWORD>

• 下图的执行指令,包含部分后面的指令的

• 输入SSH密钥的密码,就是第一步创建的

3.将ROOT.war移至<YOUR-APPLICATION>/deployments/ 目录中

• 此目录是上一步创建App时生成的,名字就是你的应用名字

4.cd 切换到 <YOUR-APPLICATION>目录中

cd ~/<YOUR-APPLICATION>

5.剩余指令

git rm -r src pom.xml
git commit -m "delete"
git push
git init
git add .
git commit -m "deploy"
git push

• 成功！（两次部署成功，均未在浏览器中打开，应该能在操作过程中找到刚创建的应用地址吧? 就是http(s)://<YOUR-APPLICATION>-<YOUR-DOMAIN>.rhcloud.com

上传App时的代码, 个人信息部分,均以”*”代替. 谢绝直接转载链接指向的代码文章

编辑APJP_LOCAL/APJP.properties

使用

双击APJP_LOCAL/APJP.sh，会看到APJP在自行测试连接服务器的讯息，如果正常会有14个“OK”

这表示APJP已经运行并连上服务器，但需要在浏览器进行简单设定，数据会经由APJP服务器流通

• 在Firefox中代理选项中，设置HTTP PROXY 为127.0.0.1 端口为10000，SSL PROXY也是127.0.0.1 端口10000

• IE Internet设置->连接->局域网设置（L）其旁边的一段话【LAN设置不应用到拨号连接。对于拨号设置，单击上面的“设置”按钮】， 如需设置和局域网设置（L）一样。->勾选“为LAN使用代理服务器”地址：127.0.0.1 端口：10000

• Firefox可使用Autoproxy(https://addons.mozilla.org/en-US/firefox/addon/autoproxy/) 扩展，选择性使用代理

• Google Chrome建议使用扩展 SwitchySharp 【项目Wiki地址https://code.google.com/p/switchysharp/wiki/SwitchySharp_GFW_List_2 】或Proxy Switchy！【Chrome Web Store地址 https://chrome.google.com/webstore/detail/caehdcpeofiiigpdhbabniblemipncjj?hl=zh-CN&hc=search&hcp=main 】

补充

APJP为web tunnel的实现，对于HTTPS连接会出现证书警告

例:

故在APJP_LOCAL-0.8.4版本，增加IAIK_JCE.jar并会随机生成APJP.pem导入浏览器内可解决证书警告问题。

以下为Windows 7版 Google Chrome的导入方法:

• 首先运行APJP_LOCAL/APJP.bat，设置好浏览器代理，打开https://www.google.com/ncr (或者其他任何 https:// URL)，出现证书警告。同时APJP_LOCAL目录中生成APJP.pem 和APJP.jks，接着如下操作:

a.选项(O)->高级设定->HTTPS/SSL->证书管理（Chrome调用的是系统的证书，即IE上不需要再导入证书）

b.点击“证书管理”->选择“受信任的证书颁发机构”->点击“导入(I)”

c.打开并指向APJP_LOCAL/APJP.pem

e.其他浏览器例如:Firefox设置导入证书大致相同

• 注意 : 每次更新APJP，都要删掉上次APJP的证书文件，再导入APJP.pem。因为证书是运行程序后自己生成的，具有唯一性。