新浪代码部署手册 git管理工具

目前新浪云上的应用支持通过Git和SVN来部署代码。

Git仓库地址	https://git.sinacloud.com/YOUR_APP_NAME
SVN仓库地址	https://svn.sinacloud.com/YOUR_APP_NAME
用户名	新浪云安全邮箱
密码	新浪云安全密码

注解

用户名和密码为安全邮箱和安全密码，不是微博账号和微博密码！如已启用微盾动态密码，则密码应该是“安全密码”+“微盾动态密码”

使用Git客户端

注解

Git代码部署只支持新创建的应用，现有已经使用SVN来部署的应用暂时无法使用Git来部署。

假设您刚刚创建了应用newapp。

首先，创建一个新的Git仓库并且添加一个Git远程仓库sae，地址为：https://git.sinacloud.com/newapp 。

$ mkdir newapp && cd newapp

$ git init

$ git remote add sae https://git.sinacloud.com/newapp

上传代码。如部署Git的主分支（master）的代码到新浪云服务器上的版本1中：

$ touch index.php

$ git add index.php

$ git commit -m"initial commit"

$ git push sae master:1

从新浪云服务器上删除版本1的代码。

$ git push sae :1

在新浪云上，应用版本对应于Git的远程分支。详细说明见：应用目录、应用版本目录、应用版本。

Git帮助文档：https://git-scm.com/book/zh/v1

最后，你可以使用 credential helper 来避免每次提交都要输入密码，如何配置可以参见：https://help.github.com/articles/caching-your-github-password-in-git/

如果使用Git-1.7.10之前的版本，在git clone或者git push的时候你可能会遇到以下这些问题，请升级Git版本之后再使用。

error: The requested URL returned error: 401 while accessing

https://git.sinacloud.com/repo/info/refs?service=git-receive-pack

fatal: HTTP request failed

Error: The requested URL returned error: 403 while accessing

https://git.sinacloud.com/repo/info/refs

fatal: HTTP request failed

Error: https://git.sinacloud.com/repo/info/refs not found: did you run git

update-server-info on the server?

注解

应用配置文件config.yaml不会被部署到用户的代码目录，但会被存储在服务端Git仓库中。

使用SVN客户端

TortoiseSVN客户端

注解

如果使用TortoiseSVN 1.8.x部署代码发生问题，请尝试更新至最新版本或者使用1.8以下的版本。

在Windows下推荐使用乌龟(Tortoise)SVN客户端。 TortoiseSVN 是 Subversion 版本控制系统的一个免费开源客户端，可以超越时间的管理文件和目录。文件保存在中央版本库（即新浪云中央SVN仓库），除了能记住文件和目录的每次修改以外，版本库非常像普通的文件服务器。你可以将文件恢复到过去的版本，并且可以通过检查历史知道数据做了哪些修改，谁做的修改。这就是为什么许多人将 Subversion 和版本控制系统看作一种“时间机器”。

TortoiseSVN下载： http://tortoisesvn.net/downloads.html

下面详细介绍使用TortoiseSVN向新浪云部署代码。

第一步，如图1，创建一个新文件夹作为本地工作目录(Working directory)，可以使用应用名为文件夹名。如，为我的应用devcenter创建本地工作目录。

第二步，从新浪云的SVN仓库检出(checkout)一个应用的全部版本代码，如图2，右键–>点击“SVN Checkout”

在弹出页面中填写仓库路径即可，这里是：https://svn.sinacloud.com/devcenter/，其它默认参数即可，如图3：

Reversion处，“HEAD revision”是指最新版，也可以指定Revision为任意一个版本。

点击“OK”，出现下载界面，如图4：

如果一切顺利，devcenter应用所有版本代码将会全部出现在刚刚创建的devcenter文件夹下，如图5：

在本地使用你喜欢的编辑器，编辑任意文件，保存后该文件图标将会出现红色感叹号，如图6所示：

看，刚刚修改过的index.php变色了。下面需要提交(commit)最近的更新。在index.php文件上击右键，出现菜单

选择“SVN commit”，如图7：

然后填写关于本次更新的日志（log message），这是必填项，否则commit会失败。如图8：

当您看到如图9所示，表明刚才的修改已经成功提交，并且前该devcenter项目的SVN版本号加1，变成30.

在SVN工作目录下，对于文件修改，完成后只需要commit就ok了，但对于新增文件，或者从其它目录复制进来的文件或文件夹，需要在commit之前需要做一步add操作，即将文件或文件夹添加到svn工作目录中来，否则SVN客户端不认它。具体操作很简单，如图10:

然后再如图7所示，右键commit 即可。

更多Tortoise SVN使用帮助，请参阅： http://www.subversion.org.cn/tsvndoc/

Notepad++集成SVN插件

Notepad++是一款Windows环境下很受欢迎的免费开源的代码编辑器，有很丰富的第三方插件。

下面介绍Notepad++的SVN插件的安装及使用。

如图12，点击Plugin –> Plugin Manager –> Show Plugin Manager

打开后，在“Available”页找到“Subversion”，然后点击“Install”，如图13所示：

安装成功后会在Plugins菜单下出现”Subversion”子菜单。

打开之前checkout下来的任一文件，如devcenter/1/index.php，编辑完成后，点击Plugins –> Subversion –> Commit File(或使用快捷键Ctrl+Alt+A)

出现熟悉的一页，如图14所示：

对，这就是乌龟SVN的Commit页面，输入Log Message，点击“OK”即可提交。

使用UltraEdit Studio部署

UltraEdit Studio(注意不是UltraEdit，UltraEdit不能与SVN整合)配置稍微复杂些。

第一步，SVN仓库账号设置，如图15所示：

然后填写仓库信息，如图16所示：

完成后，创建Project，如图17所示：

填写project名b.prj后，出现如图18所示”Project Settings”，点击“Add Folder”，出现“NewFolder”，将”Group”前的勾去掉，然后点击“Browse”，在“Browse for Folder”页找到之前checkout出现的本地工作目录。

点击“OK”后出现提示，如图19所示：

表明UEStudio自动识别出了选择的代码目录是一个SVN工作目录，并询问是否整合，点击“Yes”，出现如图20所示：

大功告成，”Close”之后即可以编辑代码，并随时commit修改。如图21所示：

使用EditPlus部署

EditPlus依赖于Tortoise SVN(TSVN)，必须先安装。

使用最简单，见图22所示：

当编辑SVN工作目录里的文件时，File –> TSVN即出现相应可操作的菜单。

SVN命令行工具

例如，您刚刚创建了应用newapp，在本地执行：

svn checkout https://svn.sinacloud.com/newapp

第一次checkout时需要验证，用户名/密码为您的新浪云安全邮箱和安全密码(非微博登陆账号密码，如已启用微盾动态密码，则此处填写“安全密码”+“微盾动态密码”)。

上传代码。如部署wordpress到版本1。

svn checkout https://svn.sinacloud.com/newapp

cd newapp/1

cp -rf /path/to/wordpress/* ./

svn add ./

svn commit -m"add wordpress"

修改代码。假如需要修改newapp应用版本1根目录下某个文件，如index.php，完整的操作流程如下：

svn checkout https://svn.sinacloud.com/newapp #如果已经checkout过了，不需要重新checkout。

cd newapp/1

vim index.php #这里编辑代码

svn commit -m "edit index.php"

注解

应用配置文件config.yaml不会被部署到用户的代码目录，但会被存储在服务端SVN仓库中。因此下次可以被checkout出来，但不会被用户访问到。

新浪云提供的SVN服务完全支持标准SVN的所有命令，更详细的使用说明请查阅SVN官方帮助文档。

SVN命令帮助文档：http://www.subversion.org.cn/svnbook/1.4/svn.ref.html
中文完全帮助文档：http://svnbook.red-bean.com/index.zh.html

SVN for 新浪云的限制条件

为了保持与新浪云兼容，使用SVN方式部署代码到新浪云有如下限制：

文件名或目录名不允许含有以下字符：”,*,?,<,>,|，另外文件或文件名的开始与结束也不允许有空格。
每个应用代码总大小不超过对应等级的配额
顶层目录下只允许存在10个以内的版本目录，目录名必须为正整数（详细见：应用目录、应用版本目录、应用版本）

常见错误说明及解决办法

错误提示	错误原因	解决方法
The change log need some words(not null)	提交时没有添加log message	提交时加上log message即可
The log message is a pathname (was -F intended?); use ‘–force-log’ to override log message	与路径名称相同	修改log message
invalid directory or file: xxx	文件不符合新浪云的目录结构规定，详细见应用目录、应用版本目录、应用版本	按照应用目录、应用版本目录、应用版本的要求组织目录结构
Too many versions, 10 allowed	版本目录多于10个，最多不超过10个	删除刚刚创建的版本目录即可
Too many files: XXX (less than 2000 is allowed).	XXX目录下文件的数量超过2000	删除XXX目录下的文件，使其总数降至2000以下
out of quota, quota: xxx, used: yyy	该应用下代码(不包括.svn目录)总大小超过配额	删除不必要的代码再尝试提交
类似Repository UUID ‘305daf1b-94be-48ee-a4b9-f4bcd36320de’ doesn’t match expected UUID ‘44e2f7a2-1b69-4710-974a-b6edef0fdc12’	服务器端仓库被删除重建，客户端对原仓库进行操作导致。	重新checkout出一份代码即可

使用在线编辑器

开发者可以在代码管理页面中选择编辑代码，使用在线编辑器来修改应用的代码。

注解

如果通过在线代码编辑器对代码进行修改/保存操作，也会和执行svn commit/git push一样，产生一个及时生效的新的提交

使用云空间+FTP

目前新浪云提供了本地可读写的云空间运行环境，相对于原新浪云环境，运行在云空间环境下的应用可以进行本地读写操作，实现更少的限制，几乎不存在迁移成本。

当选择云空间管理代码时，系统将切换到本地可读写模式，使用分布式云存储技术保存代码，保证在分布式环境下的文件读写。

选择云空间方式后，系统会提供FTP地址、FTP用户名以及FTP密码。通过任意的FTP客户端即可连接到服务器，并上传代码。代码上传成功后，应用即可正常运行。

云空间可实现本地读写，在代码目录可以直接写入文件。由程序写入的文件可以通过FTP进行管理。

使用云空间方式初始化代码管理：

使用FTP客户端（Filezilla等）进行管理：

注解

目前云空间FTP只支持被动模式，请确保您的客户端支持被动模式

代码加密

对于特殊需求的用户，特别是商业用户，新浪云提供代码加密功能支持：

对于PHP代码，我们支持Zend Guard模式加密，目前只对企业开放，需要的可以和您的客户经理联系

对于Java代码，您可以自行进行混淆，然后将混淆后的包上传

对于Python代码，您可以上传pyc二进制文件